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.
Subject:Re: Chattiness in manuals From:Beth Agnew <beth -dot- agnew -at- senecac -dot- on -dot- ca> Date:Tue, 17 Oct 2006 14:49:20 -0400
A job candidate once presented a portfolio that included a manual where
all the examples were about a Snark Factory and its production of
snarks. The manual explained how to use the software to manage snark
production. It was such a turnoff that it became difficult to evaluate
that candidate objectively. The cutesy, cloying quality of the examples
completely obscured any solid information that the manual contained. I
know it's not entirely the writer's fault; /somebody /had to approve
that, and may even have mandated it. As a user, if I had to suffer
through that to use the product, I would be seriously rethinking my
purchase.
What seems chatty and fun to us when we write it can be an insult to the
intelligence of the user. As always, know your audience and when in
doubt, stick to the proven "just the facts, Jack" writing style.
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList