> -----Original Message-----
> From: Turner, John [mailto:[EMAIL PROTECTED]]
> Sent: Tuesday, October 01, 2002 8:12 AM
> To: 'Tomcat Users List'
> Subject: RE: Documentation
>
>
>
> > -----Original Message-----
> > From: Glenn Nielsen [mailto:[EMAIL PROTECTED]]
> > Sent: Monday, September 30, 2002 6:18 PM
> >
> > I would tend to agree with the above, those writing the code
> > either don't
> > have the inclination or time to write up good documentation.
>
> In my mind, these developers should be shot. Or at least
> confined to a tiny
> little box for an extended period of time. Or maybe just put
> in charge of a
> large data center running their software, and their email and
> cell phones
> the only contact info on the 24/7/365 call list. Not to rant, but any
> developer, open source or not, that writes code but fails to
> provide good or
> better documentation at the same time is a poor developer,
> regardless of
> their technical skill, and regardless of their commitment or
> uncompensated
> participation. I'm no developer, but even I know that
> documentation is
> key...I probably spend 60% of my sys-admin time writing
> recipes and docs for
> other people to descibe what and how I did the things I did
> in the other
> 40%.
There is a big difference between writing policy and administrative doc,
and writing product documentation on a product that has a short release
cycle. I suppose you could have yearly releases with more polished
documentation, but the world is just moving faster than that so lighten
up? :-)
Bye,
Bruce Williams
A complex system that works is invariably found to have evolved from a
simple system that worked.
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
