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.
> It is refreshing to read a piece that comes across as "friendly".
> Anyone else have thoughts?
At one of my previous tech writing jobs, we tested IBM's BookMaster/
BookManager product. The manual was written for other tech writers who
would use the product to produce online (now is that hyphenated or not?)
manuals from soft copies of printed documents.
The product was OK, but the manual was fantastic. Very personably written,
tasteful use of humor, anything but dry (even though it was a very dry
topic). For example, you could configure the product in a basic or a more
complex fashion. This became the "plain vanilla" and the "mocha" configuration.
I would love to have my own copies of the manual just to show that this
style of tech writing can be done and done well.
Of course the reason IBM's writers could do this was the audience of other
writers. Writers who read the manual were delighted. (Most others were
I would love to see more manuals like this, but (sigh) most manuals aren't
written with an audience of writers (or similar literati) in mind.
Ken Stitzel (not Ken d'Albenas ;-)
Auto-trol Technology, Denver
(kensti -at- auto-trol -dot- com)