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.
>Also, I am looking for examples of tutorials that are well-written,
>especially ones of a technical nature. (Our tutorials will be used by
>electrical engineers and computer programmers; we don't want them to be
As a frequent trainer I'm *always* grateful for this attitude. It is a
tremendous help to be able to provide training to companies in which
"cutesy" is considered nonserious and where everyone is concerned with being
serious and solemn. Not only does it make it insanely easy to do great
training but it ensures that the company needs an endless amount of
organizational development work. The corporate culture is so dysfunctional
that the people need *lots* of team-building exercises, stress-management
seminars, "dealing with difficult people" training, career-change and
recareering workshops, etc.
So please, do avoid cutesy! Especially in tutorials. To the greatest
extent possible, try to make your tutorial appear to have been written *by
the machine itself.* Make sure the people using the tutorial feel a certain
sense of shame for even needing it--whatever you do, don't acknowledge that
they may be uncomfortable asking for "help" or not already knowing everything!
And, as much as possible, make sure that your tutorials display and
reinforce the idea that "This is IMPORTANT dammit! And if you're having fun
you may just not be necessary around here!"
I've gotta make those boat payments you know!
John Gear (catalyst -at- pacifier -dot- com)
The Bill of Rights -- The ORIGINAL Contract with America
Beware of Imitations. Accept No Substitutes. Insist on the Genuine Articles.