3 ms·
Germans here? Klicken sie einfach auf “Ausführen”. Click simply on “Execute”. The writers of manuals love the word “simply”. There is just one probl
by ho_schi 3y ago
Germans here?
Klicken sie einfach auf “Ausführen”.
Click simply on “Execute”.
The writers of manuals love the word “simply”. There is just one problem:
If you need instructions it is NOT simple for your users.
The word doesn’t add info. The text to comprehend becomes longer. And the task even harder for readers. I started using “einfach” too much and now delete it whenever appropriate.
- lnxg33k1 3y agoI mean sometimes things are simple, and are put in docs because someone doesn't get what's obvious, I had to sometimes to shut myself from offending people who were stuck on screens that were so obvious and instead of trying and fail or google, waited for the help of someone to unstuck them, docs exist with simple things inside and that is not enough to measure if those things are simple or not, they also exist like if that one guy who couldn't understand the obvious and had to ask, does a doc that documents something that was understood without it by 999 people, make what is documented unclear because of 1 that couldn't see? if you go to a place where you see a sign "Don't touch the fire", does it make not touching the fire not obvious because the sign exist? Or we have to put obvious sign for those who aren't cerebrally developed enough to understand it without the sign?