View Single Post
Unread 08-19-2004, 04:49 PM   #106
greenman100
Cooling Savant
 
Join Date: Jun 2004
Location: Florida
Posts: 414
Default

Quote:
Originally Posted by myv65
Agreed. Welcome to the wonderful world of technical writing. There are a few ways to approach tech writing. Yours (though generally quite accurate) is the "I sound like I know my stuff so I'm right" method. It'll work with people that are too stupid to think for themselves and haven't already been brain-washed with false impressions. Honestly I'm afraid there isn't much use in "teaching" such a group.

There's the over-the-top with theory and data approach. The only ones that will understand are those who already could figure it out, if they cared.

There's the slightly dumbed-down, full of analogies, spoon-fed-but-backed-up-with-real-science method. It doesn't get overly technical, can be understood by those with a brain who care to learn, and offers solid technical background and/or real life (and quality) data. I'm a tad biased toward this last approach as anyone who has read some of my stuff knows.

No matter the approach, resign yourself to one simple fact. Regardless of how right you are, how well you prove it, and how well you present it, someone will still argue that you are wrong. Such is life.

Personally I got a little burned out explaining the same concepts time and again at varied forums. Sure, lots of people took my words to heart and actually learned something, but I could only do it so long. A full time job and three kids kinda took the wind out of my writing sails.

I wish you best of luck in your endeavor for though your goals are noble your task is unending.

I think a big part of tech writing is target audience. Yes, the article may not have shown proof, but show me a part of it you think is wrong, and we'll talk. A relatively weak target audience is no excuse for misinformation, but it is a reason to keep things simple.
__________________
"Employ your time in improving yourself by other men's writings, so that you shall gain easily what others have labored hard for."
--Socrates
"greenman100 = obnoxious ass hole"-gazorp

Last edited by greenman100; 08-19-2004 at 04:56 PM.
greenman100 is offline   Reply With Quote