Re: Quote of the Day

Subject: Re: Quote of the Day
From: Jim Barrow <vrfour -at- verizon -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 30 Aug 2007 08:27:47 -0500 (CDT)

>Gene Kim-Eng <techwr -at- genek -dot- com> wrote:
>>Ladonna Weeks <ladonna -dot- weeks -at- comtrak -dot- com> said:
>> The few times I've run into developers with negative attitudes
>> toward tech writers, I remind them that if it weren't for us,
>> they would have to write the documentation (as in the old days).
>> Since many of them would hate writing documentation (even if they
>> could), that seems to help them see value in our profession.
>I've never experienced this attitude from a developer
>who has had to write his/her own documents. Those
>people usually greet me on first meeting with some
>remark like "Am I glad you're here." The ones most
>likely to have the attitude are the ones who've never
>had to do their own docs and would never be able
>to if they did.

That's one possibility. In my case the developers mistakenly believe that they would be able to produce required documentation from the JavaDoc tool. I don't mean that they think they can generate their comments, I mean they think they would be able to generate fully-formatted, ready-for-publication documents, replete with graphics, TOC, headers and footers.

- Jim

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.


Previous by Author: Re: What do you call your examples?
Next by Author: RE: an apology (LinkedIn fiasco)
Previous by Thread: Re: Quote of the Day
Next by Thread: Re: Quote of the Day

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

Sponsored Ads