Re: What good is it if you can't find it?

Subject: Re: What good is it if you can't find it?
From: Jan Henning <henning -at- r-l -dot- de>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sat, 16 Nov 2002 13:54:13 +0100


It is simply that writers frequently do not consider the content important enough for them to take the time to understand.

Sure, and these are bad writers that create bad documentation.

But what about the other extreme that, e.g., Andrew sometimes seems to propagate? What is a writer who concerns him- or herself with nothing but content?

Sometimes, this is a writer who is lucky enough to work in a well-organized documentation department where others do the design work for him or her. But when that context isn't there, such a writer is making him- or herself nothing more than a glorified SME.

I agree with you that writers who do not take care to understand the content in enough depth cannot help but be bad writers. But IMHO a writer who only considers content also is a bad writer (unless there is somebody else to do the design stuff).

In the end, a good writer is somebody who can produce good documentation in a timely manner. And good documentation needs to be accessible as well as correct.

But, again, I do not dispute that writers who disregard content can never produce good documentation. (Except by accident ;-)

Regards
Jan Henning

--------------------------------------------------------------------
Jan Henning
ROSEMANN & LAURIDSEN GMBH
Am Schlossberg 14, D-82547 Eurasburg, Germany

Phone: +49 700 0200 0700, Fax: +49 8179 9307-12
E-Mail: henning -at- r-l -dot- de, Web: www.r-l.de
--------------------------------------------------------------------



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

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

---
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: What good is it if you can't find it?: From: Jason Deal

Previous by Author: Re: What good is it if you can't find it?
Next by Author: Re: What good is it if you can't find it?
Previous by Thread: Re: What good is it if you can't find it?
Next by Thread: Re: What good is it if you can't find it?


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


Sponsored Ads