tomcat-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bruce Williams <midnightco...@comcast.net>
Subject RE: Documentation
Date Tue, 01 Oct 2002 14:55:56 GMT


> -----Original Message-----
> From: Turner, John [mailto:JTurner@AAS.com]
> Sent: Tuesday, October 01, 2002 8:12 AM
> To: 'Tomcat Users List'
> Subject: RE: Documentation
>
>
>
> > -----Original Message-----
> > From: Glenn Nielsen [mailto:glenn@mail.more.net]
> > 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:tomcat-user-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:tomcat-user-help@jakarta.apache.org>


Mime
View raw message