Re: The cost of inaccurate technical documentation

Subject: Re: The cost of inaccurate technical documentation
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: "John Posada" <jposada01 -at- yahoo -dot- com>, "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 28 Mar 2007 11:44:35 -0700

I would go further than that. Legal documents are intended
to take simple concepts (justice, fair play, keeping one's
word, doing what's right and ethical), make them so
complicated that you can't possibly understand them and
don't dare try to without hiring a lawyer and enable those
who do hire lawyers to twist them around to suit any
desired interpretation. They're not just far apart from
technical documents, but are completely opposite in their
intended function.

Gene Kim-Eng


----- Original Message -----
From: "John Posada" <jposada01 -at- yahoo -dot- com>


>Tech documents take difficult concepts and describe them
> simply. Legal documents intentionaly allow for interpretation.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual: http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

References:
Re: The cost of inaccurate technical documentation: From: John Posada

Previous by Author: Re: Getting Black Balled by a Doc Manager & Filing forUnemployment-Need Advice
Next by Author: Re: Tech Writers & Educational Material
Previous by Thread: RE: The cost of inaccurate technical documentation
Next by Thread: Re: The cost of inaccurate technical documentation


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

Sponsored Ads


Sponsored Ads