Mailinglist Archive: opensuse (2525 mails)

[Doug McGarrett <dmcgarrett@xxxxxxxxxxxxx>]

At 12:34 AM 11/20/2009 +1100, Basil Chupin wrote:
> On 20/11/09 00:22, Carlos E. R. wrote:
> > -----BEGIN PGP SIGNED MESSAGE-----
> > Hash: SHA1
> >
> > On 11/19/2009 01:53 PM, Basil Chupin wrote:
 
> > > And to top it all all off, manuals are written for those people who
> > > already KNOW about the subject; manuals are NOT written to provide the
> > > novice with the necessary information to resolve his/her query. 
> > >     
> > True.
> >
> > Worse, many programmer write poor documentation, if any.
> >   
>
> Oh, so true!
>
> The thing that a programmer abhors the most is writing
> documentation.....particularly when they don't know about the program
> they are programming :-) .
>
> BC
I am writing a tribute to a programmer I worked with for quite a few years,
when I was still working as an engineer.  Her name is Cathy.  She works
for what is now a part of Honeywell, the part that was Ademco at the time.
She is an excellent programmer, she knows Unix but doesn't use it in her
present position, and she is an excellent writer and editor of installer and
user manuals.  Not everybody should be tarred by the same brush!

--doug
-- 
To unsubscribe, e-mail: opensuse+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse+help@xxxxxxxxxxxx