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.
Funny, I assumed the writer was the "instruction manual/layout" person, who was also a guy, not the copywriters.
I think humor is a purely "know your audience" issue, mundane as that might sound. In this case we have a guide that's primary goal is to make sure people feel good about their purchase, make them feel like the product is something they can use effectively, that it's not hard to manage, and most importantly that they'd buy again when a bus runs over the first one.
There's a big difference between what this writing is trying to accomplish and what a nuclear waste dump manual, or even most work-based instructional material is doing.
BTW--I think "risky" is an interesting term to use when describing why not to use humor. Of all the ways we choose to write technical information, humor is nowhere near the most "risky", although I think that depends on what we're afraid of. If we're afraid that people won't like us, won't think we're funny, then, yes, I guess actually trying to be funny is risky. If, however, we're afraid people won't read our work or won't understand it when they do, then dry, boring, badly organized writing is way more risky.
(who is looking at the world through newly lasered eyes, 20/20 for the first time in 29 years)
Experience RoboHelp X3! This new RoboHelp release combines single sourcing,
print-quality documentation, conditional text and much more, into the most
monumental release of RoboHelp ever! http://www.ehelp.com/techwr-l
Enhance, optimize and automate your FrameMaker-to-PDF workflow with TimeSavers:
Define all PDF features in your source FrameMaker files ONCE, distill MANY.
Bookmark Controller, Link Controller, UnBloat & more : http://www.microtype.com
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.