[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Gnumed-devel] re previous stuff
From: |
Karsten Hilbert |
Subject: |
Re: [Gnumed-devel] re previous stuff |
Date: |
Thu, 29 May 2003 11:26:07 +0200 |
User-agent: |
Mutt/1.3.22.1i |
> Karsten objected to your proposals / implementations
> because he did not understand them.
I did not even intend to (although I may have failed in that)
object to the concepts put forth but rather objected to my
being left ignorant about them. Even after repeatedly
expressing my persisting ignorance.
> I give him a point in that documentation is lacking,
> but I am guilty in that aspect as well.
When formal docs are lacking the code can make all the
difference. I have been commenting undocumented code before.
But that was understandable code and its intent was intuitive
by good naming of variables, methods, and classes. Applying
the lingo of a certain programming language goes a great deal
towards self-documenting code. I too, of course, have been subject
to justified requests for documentation by, say, Hilmar.
> The proposal is that whenever somebody submits something really new to
> CVS, he/she should really advertise this fact on this list and explain
> in detail why and how to use it.
Fully agreed.
Karsten
--
GPG key ID E4071346 @ wwwkeys.pgp.net
E167 67FD A291 2BEA 73BD 4537 78B9 A9F9 E407 1346