Programmers as writers

Subject: Programmers as writers
From: Peterson Karen <Peterson_Karen -at- PRC -dot- COM>
Date: Mon, 21 Jun 1999 17:53:49 -0400

Dear Techwhirlers,

Our programmers do a lot of documentation, such as functional design specs.
Because these docs go to our client, they must conform to the clients'

I just spent quite a while peer reviewing a programmer's doc. Some of my
edits dealt with style and mechanics, but there were also a lot of content
issues--the programmer is clearly not trained in writing requirements. I'm
sure it would have taken far less time all around if I had written this doc

Should we "let" programmers write documentation? Should we just make sure we
get involved as editors? I've had a lot of luck with getting the programmers
to come to me with questions, but I don't think our clients should be
wasting money paying a programmer to write.

I've searched the archives about this without much luck. What are your

Thanks so much,

From ??? -at- ??? Sun Jan 00 00:00:00 0000=

Previous by Author: Completely intuitive software
Next by Author: Re: Interview from hell
Previous by Thread: Standards Update
Next by Thread: Re: Programmers as writers

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

Sponsored Ads