Re: Nobody reviewed the manuals

Subject: Re: Nobody reviewed the manuals
From: <neilson -at- windstream -dot- net>
To: Marguerite Krupp <mkrupp128 -at- yahoo -dot- com>, Al Geist <al -dot- geist -at- geistassociates -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 10 Jun 2010 14:13:09 -0400

---- Marguerite Krupp <mkrupp128 -at- yahoo -dot- com> wrote:
> ... this or that was wrong or didn't work that way. When I investigated,
> the issues were mostly in sections that I hadn't cleaned up, but that
> had been so obscured by the bigger issues that nobody noticed them.

More than once (indeed, several times) I have been asked to provide for review only those portions of the manuals in which I made changes, sometime marked with revision bars. This is to avoid wasting effort re-reading material that has already been reviewed.

Only in the very final review, often after the product has been shipped, have there been complaints that the non-reviewed portion of the manual contained errors. And of course it was the tech writers' fault.

All this sort of stuff (including the failure to RTFM) has been known and hashed about since long before there was an internet, and perhaps before there were computers. There is a PhD in archeology out there waiting for the person who can show for certain whether anyone actually read the cuneiform tablets of Babylon before their discovery in recent times.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Gain access to everything you need to create and publish documentation,
manuals, and other information through multiple channels. Choose
authoring (and import) as well as virtually any output you may need.
http://www.doctohelp.com/


- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -


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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Re: Nobody reviewed the manuals: From: Marguerite Krupp

Previous by Author: Re: Nobody reviewed the manuals
Next by Author: Re: HR Pubs and Policies & Procedures Manuals
Previous by Thread: RE: Nobody reviewed the manuals
Next by Thread: RE: Nobody reviewed the manuals


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


Sponsored Ads