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.
>At the simplest level, it's worth noting that anything you have
>trouble documenting is something that your audience will have trouble
>using.
Absolutely right. I once found myself writing an explanation of three or
four ways of printing a display, depending on the function, in a *Windows*
application. I told the developer, "This is Windows. Users want *one* way to
print." "But you can't print every screen," he replied. "That's what error
messages are for," I said. "If they can't print from the particular screen,
tell them that. Better yet, grey out the Print button and the menu item." To
his credit, he did it.
--Wayne
---------------------------------------------
Wayne Douglass phone: 408-542-2139
Verity, Inc. FAX: 408-542-2040
894 Ross Road mailto:wayned -at- verity -dot- com
Sunnyvale, CA 94089 http://www.verity.com
---------------------------------------------
