2 ms·
I hate this kind of documentation so much. The kind I hate the very most is the application manual that is constructed by dumping out the menu tree and then hav
by wpietri 8y ago
I hate this kind of documentation so much. The kind I hate the very most is the application manual that is constructed by dumping out the menu tree and then have somebody write something about every menu function. 85% of the prose being what any idiot could guess from the words clicked on to get there.
My plea to everybody: user-test your documentation. Give the thing to a novice, have them do tasks, see if they can figure it out. If nobody looks at the docs, great, just throw them out. But if they do look, make sure it is useful to the person who is looking.