gnumed-devel
[Top][All Lists]
Advanced

[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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]