Date: Fri, 03 May 2002 16:46:12 -0700 From: Bakul Shah <bakul@bitblocks.com> To: Terry Lambert <tlambert2@mindspring.com> Cc: 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: <200205032346.TAA15927@glatton.cnchost.com> In-Reply-To: Your message of "Fri, 03 May 2002 11:21:07 PDT." <3CD2D513.C6566342@mindspring.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Terry Lambert writes: > JJ Behrens wrote: > > The online documentation for PHP allows users to post comments at the end o > f > > every page of the online documentation. Often times, these comments serve > to > > enlighten others about various quirks of the libraries. Perhaps doing the > same > > thing with the FreeBSD handbook pages (only online) might be a good idea. > > The problem with this (and the similar "FAQ-o-matic") approach > is that they are very deep. > > In other words, you have to go through a large set of branch > points to get to the information. > > 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). It is interesting to note that the plan9 people from the same Bell Labs are using a wiki for "information pertinent to installing, configuring, and using the operating system Plan 9 from Bell Labs."! http://plan9.bell-labs.com/wiki/plan9/plan_9_wiki/index.html To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200205032346.TAA15927>