From owner-freebsd-hackers Fri May 3 16:46:31 2002 Delivered-To: freebsd-hackers@freebsd.org Received: from glatton.cnchost.com (glatton.cnchost.com [207.155.248.47]) by hub.freebsd.org (Postfix) with ESMTP id 6AD1D37B419; Fri, 3 May 2002 16:46:26 -0700 (PDT) Received: from bitblocks.com (adsl-209-204-185-216.sonic.net [209.204.185.216]) by glatton.cnchost.com id TAA15927; Fri, 3 May 2002 19:46:13 -0400 (EDT) [ConcentricHost SMTP Relay 1.14] Message-ID: <200205032346.TAA15927@glatton.cnchost.com> To: Terry Lambert Cc: JJ Behrens , Dave Hayes , Brooks Davis , Michael Sierchio , Drew Tomlinson , bmah@FreeBSD.ORG, freebsd-hackers@FreeBSD.ORG, freebsd-stable@FreeBSD.ORG Subject: Re: organic documentation In-reply-to: Your message of "Fri, 03 May 2002 11:21:07 PDT." <3CD2D513.C6566342@mindspring.com> Date: Fri, 03 May 2002 16:46:12 -0700 From: Bakul Shah Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG 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-hackers" in the body of the message