Date: Fri, 3 May 2002 13:28:20 -0700 From: David Schultz <dschultz@uclink.Berkeley.EDU> To: "R. David Murray" <bitz@bitdance.com> Cc: Terry Lambert <tlambert2@mindspring.com>, JJ Behrens <jj@nttmcl.com>, Dave Hayes <dave@jetcafe.org>, Brooks Davis <brooks@one-eyed-alien.net>, Michael Sierchio <kudzu@tenebras.com>, Drew Tomlinson <drew@mykitchentable.net>, bmah@FreeBSD.ORG, freebsd-hackers@FreeBSD.ORG, freebsd-stable@FreeBSD.ORG Subject: Re: organic documentation Message-ID: <20020503132820.A24949@HAL9000.wox.org> In-Reply-To: <20020503142917.H32803-100000@twirl.bitdance.com>; from bitz@bitdance.com on Fri, May 03, 2002 at 02:34:40PM -0400 References: <3CD2D513.C6566342@mindspring.com> <20020503142917.H32803-100000@twirl.bitdance.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Thus spake R. David Murray <bitz@bitdance.com>: > On Fri, 3 May 2002, Terry Lambert wrote: > > Aside from the classification problem (everyone has to classify > > the same way for them to be able to get the information out), > > the human factors argue that the depth should not exceed 3 on > > any set of choices, before you get to what you want (HCI studies > > at Bell Labs confirms this number). > > Sorry for dropping in to the middle of a conversation, but this > comment puzzles me. I fail to see how: > > handbook + per-page comments from readers > > is *inferior* to: > > handbook with no comments I remember those comments in the PHP manual from back when I used PHP. More often than not, they were wrong or misleading. Yes, this is worse than no comments at all. Anyone can submit changes to the FreeBSD documentation as it is; they're just forced to carefully think out the changes they want to make, rather than submitting one-line apothegms from a web browser. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020503132820.A24949>