[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

Re: Article: "Living Documentation"

Subject: Re: Article: "Living Documentation"
From: Bruce Byfield <bbyfield -at- axionet -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 04 Apr 2003 10:57:17 -0800


eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com wrote:

Another inflamitory statement and a red herring. If the writer is to actually do
some writing, they're going to have to base some of their facts on
engineering and development data and documentation. If those
documents/data are erroneous, then it certainly isn't the writers fault
that there's an error.

The trouble is, you're starting from a different premise than Andrew. Andrew is assuming that a tech-writer can or should be enough of an expert that he or she doesn't have to accept developer's information uncritically. You're assuming a dependency on the developers. Given this difference, the two of you can hardly help coming to a different conclusion.

--
Bruce Byfield bbyfield -at- axionet -dot- com 604.421.7177
http://members.axion.net/~bbyfield

"There'll be tears in the eys of the weak,
And in the eyes of the most strong-hearted,
Tears in the eyes of the miners and wives
When these coal town days are through."
-Jez Lowe, "These Coal Town Days"



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Purchase RoboHelp X3 in April and receive a $100 mail-in rebate, plus FREE RoboScreenCapture and WebHelp Merge Module. Order here: http://www.ehelp.com/techwr-l

Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday 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.


References:
RE: Article: "Living Documentation": From: eric . dunn

Previous by Author: Re: Article: "Living Documentation"
Next by Author: Re: memberships
Previous by Thread: RE: Article: "Living Documentation"
Next by Thread: RE: Article: "Living Documentation"

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

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

Sponsored Ads