[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Linux is not for consumers!



On Thu, 11 Dec 2003 15:58:25 -0700, s. keeling wrote:

> 
> If you need to understand it to use it, you've got the source.  What
> more could you need?  That's not good enough?  Don't use it.  You
> think it would be better with good documentation?  Great.  Go write
> some.  Oh, you want me to write some?  Why?  I don't think it needs
> it since I have no trouble using it.
> 

Try reading uncommented source.  Even stuff you wrote yourself.  Part of
documentation is comprehensive commenting of source code.  It is a pain to
write, but if one is writing code which someone else may have to maintain
or understand, and one has not documented one's source, then one has done
a half-assed job and should be condemned to a year of writing COBOL
accounting programs with a line editor.

-- 
....................paul

"Do the little things" ("Gwnewch y pethau bychain")

St. David (Dewi Sant) of Wales, last sermon, Sunday 27th February 589




Reply to: