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.
John David Hickey wondered about the usefulness of "simply" and
"easily" in documentation. My response: lose them both, because they
add nothing and may actually detract from the document. If the
procedures are either simple or easy, this will be self-evident
(i.e., the words are redundant); if the procedures are neither
(which will always be the case for some portion of your audience),
then you've just lost any confidence the audience had in you. I call
this a no-win situation, not so?
--Geoff Hart @8^{)}
geoff-h -at- mtl -dot- feric -dot- ca
Hart's corollary to Murphy's law: "Occasionally, things really do work right."
