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.
Mark Baker writes:
>If you want ham and eggs, you needs ham, and you need eggs. It is pointless
>to argue which is more important. The whole point of ham and eggs is that
>you have both ham and eggs. Sine qua non.
Yes, this is true... my point is, though, you cook the eggs separately from
If you cook them all together, you get some unidentifiable breakfast, with
either burnt eggs or raw ham.
Typically, a complete set of documents has several parts. Marketing may need
an overall description of a product that DOES NOT NEED technical accuracy
beyond a certain level of specificity-in fact, too much detail may give away
trade secrets. But there needs to be enough accurate technical information
for potential buyers to assess whether the product will address their needs.
Then, you may need a set of instructions for administrators to install and
configure a complex program, step-by-step, covering information that end
users of the product never need to know.
A users guide may cover a completely different part of a product, and not go
into the technical administration.
A reference manual may cover all features and all configuration details of a
product, and should be organized however it makes sense. This type of
document may not need to consider the audience at all.
These are all technical writing... we, as technical communicators, need to
assess the purpose of each document, and choose what is most important for