Re: Proof that content is more important than style

Subject: Re: Proof that content is more important than style
From: eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 18 Nov 2002 10:20:37 -0500




<<As you know: accuracy is simply the single most important aspect of any
technical manual. >>

If we know, why do the straw armies have to be set up again and again to make
the point? Everybody is arguing/destroying their own straw men in this thread
anyways.

<<The thousands of RFC documents generated to outline networking and Internet
standards are exceptionally homely, inconsistent, and short on style.>>

But these documents are also the products of extremely controlled processes.
Something some would tell us are counterproductive to good technical writing.
<LOL>

Seriously though, RFCs are helpful and serve their purpose for a semi-expert
audience. As far as helping the average person out they are lacking.

Eric L. Dunn




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

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!

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


Previous by Author: Re: FrameMaker Vs Word
Next by Author: Re: Documenting for the non-typical user? WAS: Fields arranged as a sentence
Previous by Thread: Re: Proof that content is more important than style
Next by Thread: Re: Proof that content is more important than style


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


Sponsored Ads