RE: Funny Tech Writing

Subject: RE: Funny Tech Writing
From: "Wilcox, Rose (ZB5646)" <Rose -dot- Wilcox -at- pinnaclewest -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 23 Sep 2002 09:40:24 -0700


I also am in that group. While I would not advocate using puns in a
technical document, I do feel that the occasional vernacular word (like
"nifty") or a bit of humor can improve readability. The trick is to avoid
overdoing it.


Another potential problem besides overdoing it is localization. If your words ever have to be translated into another language, humor or the vernacular may provide stumbling blocks to the translator. Even if you aren't going to be translated ever, many audiences contain people reading English as a second language and in that case, your efforts may backfire. Just thoughts to consider when writing.

Rosie Wilcox

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 :

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!

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 for more resources and info.


Previous by Author: RE: techwr-l digest: September 18, 2002
Next by Author: RE: Job Market In The Next 6 Months
Previous by Thread: RE: Funny Tech Writing
Next by Thread: RE: Funny Tech Writing

What this post helpful? Share it with friends and colleagues:

Sponsored Ads