Date: Fri, 03 May 2002 11:21:07 -0700 From: Terry Lambert <tlambert2@mindspring.com> To: JJ Behrens <jj@nttmcl.com> Cc: 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: <3CD2D513.C6566342@mindspring.com> References: <200205030637.g436bab89675@hokkshideh2.jetcafe.org> <20020503111558.A2534@alicia.nttmcl.com>
next in thread | previous in thread | raw e-mail | index | archive | help
JJ Behrens wrote: > The online documentation for PHP allows users to post comments at the end of > 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). -- Terry 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?3CD2D513.C6566342>