Tip 33 - what's your problem?
Much of our documentation covers what happens when things work properly. Sometimes, our writing is for when things go wrong.
And when things go wrong, the first thing our readers experience is that something is not functioning as expected. They may have already realized what caused the error (step 2) when they consult our docs. But itās likely they have not yet progressed to step three: knowing what to do about it. Thatās what weāre for!
One PR suggestion I will make is to follow the readerās journey through an issue they way they experienced it. The cause of the error may be unknown to them, but they can identify the problem they are having.
-
ā If the Translation Status Overview incorrectly shows āneeds updatingā for a page (e.g. a typo fix to an English page was merged without the āignoreā label and triggered the status update), take the following steps to manually update the tracker:
-
š If a PR that should have been marked as an ignored change was merged without the label, the Translation Status Overview will consider the pageās translations as āneeds updatingā when there are no changes to translate. If this occurs, and there arenāt any other updates needed for that translation, take the following steps to manually update the tracker:
Starting from the reason to explain what goes wrong feels to me like, āFun fact: if you do this, this will happen!ā Iām not entirely convinced that fact is so fun to someone whoās experiencing it.
Toggle Comments
Ā© 2021 - 2024 Sarah Rainsberger. Except where otherwise noted, and/or quoting external sources, the content of this site is licensed under CC BY-NC-SA 4.0