Re: "Two-track" documentation

Subject: Re: "Two-track" documentation
From: "Dick Margulis" <margulis -at- mail -dot- fiam -dot- net>
To: techwr-l -at- lists -dot- raycomm -dot- com
Date: Mon, 13 Dec 99 07:43:03 -0500

Andrew Plato wrote a not-very-amusing accusation that Tom Murrell fills his documentation with inaccuracies. Maybe I missed something, but I didn't get that from Tom's assertion that a tech writer ought to keep the audience in mind.

Andrew, it is possible to be accurate, to write well, and to consider issues like readability, audience needs, and productivity of tools. Certainly someone as brilliant as you claim to be can handle all that at once, right?

Tech writing is not a zero-sum game. Gaining an understanding of the audience does mean losing accuracy. Just get over it, Andrew.

Dick




Previous by Author: Re: Inconsistent lines in .PDF files...
Next by Author: Re: "Two-track" documentation
Previous by Thread: Re: "Two-track" documentation
Next by Thread: Re: "Two-track" documentation


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


Sponsored Ads