RE: Living documents?

Subject: RE: Living documents?
From: "Nuckols, Kenneth M" <Kenneth -dot- Nuckols -at- mybrighthouse -dot- com>
To: "James Jones" <doc-x -at- earthlink -dot- net>, "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 16 May 2006 08:43:15 -0400

Jim Jones said...

>
> Is 'living' document a regular way of describing them? Anyway, I like
this
> nomenclature and I'd guess that an immutable document, one that is not
> modified too much over the years, would still be a 'living' document.
A
> dead
> one I guess would be one that is no longer used for any kind of
reference.
>

When I think of a "living" document, I don't think of a piece of
technical communication, no matter how often it's revised or updated. I
think of something like the U.S. Constitution, and I've always thought
of that as "living" because it is re-interpreted by every generation to
have slightly varying shades of meaning, and as new laws are passed and
challenged and new judicial philosophers are appointed to the Supreme
Court over the years, the scope and the limit of its words "breathe" in
and out.

A technical document, IMO, should never be "living" in that sense. If it
is well-written, it should not be "open to interpretation" by its
audience. If there's ambiguity or obfuscation, that should be edited out
in a revision to provide a clearer and more focused document.

Laws that govern a society need to be "living" and open to
interpretation to prevent a rise of totalitarianism or a descent into
anarchy; instructions for how to disarm an atomic weapon or repair the
engine of a passenger jet need to be absolutely devoid of any ambiguity
or room for interpretation. I don't know if I'd call them "dead," but I
certainly wouldn't classify them as "living" in the same way a body of
law is "living."

That's just my $0.02; as always, YMMV


CONFIDENTIALITY NOTICE: This e-mail and any files transmitted with it may contain information that is privileged, confidential or otherwise protected from disclosure. If you are not the intended recipient of this e-mail, please notify the sender immediately by return e-mail, purge it and do not disseminate or copy it.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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%40infoinfocus.com


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

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


Previous by Author: RE: Programs to create a software walk-through?
Next by Author: RE: Conducting Telephone Interviews
Previous by Thread: Re: Living documents?
Next by Thread: RE: Living documents?


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


Sponsored Ads