From owner-freebsd-stable Fri May 3 11:21:47 2002 Delivered-To: freebsd-stable@freebsd.org Received: from falcon.prod.itd.earthlink.net (falcon.mail.pas.earthlink.net [207.217.120.74]) by hub.freebsd.org (Postfix) with ESMTP id 57FEA37B41A; Fri, 3 May 2002 11:21:41 -0700 (PDT) Received: from pool0248.cvx40-bradley.dialup.earthlink.net ([216.244.42.248] helo=mindspring.com) by falcon.prod.itd.earthlink.net with esmtp (Exim 3.33 #2) id 173hgX-0005Ww-00; Fri, 03 May 2002 11:21:37 -0700 Message-ID: <3CD2D513.C6566342@mindspring.com> Date: Fri, 03 May 2002 11:21:07 -0700 From: Terry Lambert X-Mailer: Mozilla 4.7 [en]C-CCK-MCD {Sony} (Win98; U) X-Accept-Language: en MIME-Version: 1.0 To: JJ Behrens Cc: Dave Hayes , Brooks Davis , Michael Sierchio , Drew Tomlinson , bmah@FreeBSD.ORG, freebsd-hackers@FreeBSD.ORG, freebsd-stable@FreeBSD.ORG Subject: Re:organic documentation References: <200205030637.g436bab89675@hokkshideh2.jetcafe.org> <20020503111558.A2534@alicia.nttmcl.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-stable@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG 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