Date: Tue, 22 Jun 1999 19:26:55 -0400 (EDT) From: Chuck Robey <chuckr@picnic.mat.net> To: Greg Lehey <grog@lemis.com> Cc: Mike Smith <mike@smith.net.au>, hm@hcs.de, dfr@nlsystems.com, peter@FreeBSD.org, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: Documentation (was: cvs commit: src/sys/isa sio.c) Message-ID: <Pine.BSF.4.10.9906221922320.393-100000@picnic.mat.net> In-Reply-To: <19990623083551.P76907@freebie.lemis.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 23 Jun 1999, Greg Lehey wrote: > Well, I started this thread, though that's not me that Mike anonymized > above. My statement was "it would be nice if...". The fact is that > the original authors of the software are in the best position to > document it, *if* they have the will to do so. They don't have to > document every bit and byte, but it helps if they can explain the > rationale behind what they're doing (like abstracting the "is > configured" bit into a macro, and describing who should be allowed to > mess in the private parts of the config routines). Agreed, in a > volunteer project there's no way to force people to do this, but a > consensus of "what's right" can help. Oh, sticking something like this into the docs, as long as it's friendly and not dictatorial, would be a fine thing... Putting something like that in the handbook, well, it might help by embarrassing folks into it. That's the strongest method available in our project. We can say don't absolutely, but we can't say "do" absolutely. ----------------------------+----------------------------------------------- Chuck Robey | Interests include any kind of voice or data chuckr@picnic.mat.net | communications topic, C programming, and Unix. 213 Lakeside Drive Apt T-1 | Greenbelt, MD 20770 | I run picnic and jaunt, both FreeBSD-current. (301) 220-2114 | ----------------------------+----------------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.4.10.9906221922320.393-100000>