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
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
