TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
<snip>
Too much condescending information is annoying and will alienate your
readers. Do you still tell them to "Press
Enter" after every command?
<snip>
Salette Latas answers:
I tell users to press Enter when they need to press Enter. I document many
applications with screens that look like forms. Many users are accustomed to
pressing Tab to move between fields in a form. If they press Tab on this
particular system, the current field is cleared. Perhaps this is not a good
UI, but my job is tell the users how to work with it anyway.
Isn't it almost as condescending to assume that more experienced users of
the system won't be able to read my instructions and skip the parts they
already know?
