Date: Tue, 22 Jun 1999 11:25:13 +0200 (MET DST) From: Nick Hibma <nick.hibma@jrc.it> To: Mike Smith <mike@smith.net.au> Cc: Greg Lehey <grog@lemis.com>, hm@hcs.de, dfr@nlsystems.com, peter@FreeBSD.ORG, cvs-all@FreeBSD.ORG, FreeBSD Hackers <hackers@FreeBSD.ORG> Subject: Re: All this and documentation too? (was: cvs commit: src/sys/isa sio.c) Message-ID: <Pine.GSO.3.95q.990622112214.25186u-100000@elect8> In-Reply-To: <199906220842.BAA01553@dingo.cdrom.com>
next in thread | previous in thread | raw e-mail | index | archive | help
In short: Where's the patch?
And as to the author: Writing docu while you are implementing something
might work in a commercial environment where you want to be able to
market something before it's sell-by date, but for hobbiests who
basically spend the odd evening doing something, it is too much hassle.
Writing the manual after the fact or manuals written by someone
else are far easier to get coherent and useful.
Nick
> Perhaps I should have been clearer; the sort of documentation that the
> original set of plaintiffs were asking for is the mythical "describe
> everything as it was, is and will be, and make it constantly
> representative and up to date". These are the same people that will
> complain about disparities between any extant documentation and
> reality, as well as carp incessantly about the lack of some form
> of documentation other than what already exists ("why isn't there a
> permuted index?" "where's the sanskrit translation?" "my cat can't read
> _this_!").
>
> As always, complaining about the _lack_ of something is the wrong
> approach for this project. Step up and fill the gap, or expose
> yourself to criticism for failing to do so. There has to be a way to
> make a verb from Brett Glass' name, but I'm sure you get the point.
>
> --
> \\ The mind's the standard \\ Mike Smith
> \\ of the man. \\ msmith@freebsd.org
> \\ -- Joseph Merrick \\ msmith@cdrom.com
>
>
>
>
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-hackers" in the body of the message
>
>
--
ISIS/STA, T.P.270, Joint Research Centre, 21020 Ispra, Italy
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.GSO.3.95q.990622112214.25186u-100000>