RE: what I recently heard

Subject: RE: what I recently heard
From: Chris Gooch <chris -dot- gooch -at- lightworkdesign -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 15 Nov 2002 11:46:47 -0000



Sean Hower wrote:

+++
i recently heard someone say the following:

"I'd almost rather have it [the content of docs] be consistent and be wrong,
than to have documents that aren't consistent."

i didn't really know how to respond to this. I was kind of dumbfounded
actually. What's a good way to respond to such a statement?
+++


No-one seems to have picked up on the word "almost" in
the original comment. Seems a perfectly sensible comment
to me - an attempt to make a strong case for consistency.
I doubt that anyone would really want incorrect content,
but consider this; if your docs refer to some feature by
an incorrect name _consistently_ readers will be less
confused than if your docs refer the feature by a number
of _different_ names, as they only have to remember
one extra fact to make sense of it all. So the point is,
if you fix something in one place, make sure you
fix it everywhere.

Christopher Gooch, Technical Author
LightWork Design, Sheffield, UK.
www.lightworkdesign.com




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

Order RoboHelp X3 in November and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

---
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.



Follow-Ups:

Previous by Author: Re: What's So Common About Content
Next by Author: free tool for PDF annotation?
Previous by Thread: RE: what I recently heard
Next by Thread: Re: what I recently heard


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


Sponsored Ads