From owner-freebsd-hackers Fri May 3 17: 4:16 2002 Delivered-To: freebsd-hackers@freebsd.org Received: from albatross.prod.itd.earthlink.net (albatross.mail.pas.earthlink.net [207.217.120.120]) by hub.freebsd.org (Postfix) with ESMTP id 806FC37B431; Fri, 3 May 2002 17:03:52 -0700 (PDT) Received: from pool0260.cvx40-bradley.dialup.earthlink.net ([216.244.43.5] helo=mindspring.com) by albatross.prod.itd.earthlink.net with esmtp (Exim 3.33 #2) id 173n1X-00077E-00; Fri, 03 May 2002 17:03:40 -0700 Message-ID: <3CD3253D.1500D66@mindspring.com> Date: Fri, 03 May 2002 17:03:09 -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: Bakul Shah 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 References: <200205032346.TAA15927@glatton.cnchost.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit 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 Bakul Shah 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). > > 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 This is a perfect example of "everyone has to classify the same way". It also demonstrates the other problem of hierarchical categorization, which is that it's impossible to get a single document with all the information on it so it can be linearly searched (e.g. via a browser "find text"). You end up having to provide a seperate search facility (the Plan 9 wiki lacks one of these), and index the content to make it searchable. This generally isn't very satisfactory in realization, even if you provide such a search function, since what's an important keyword or key phrase to you is often not important to the indexing software (simple indexing fails to identify phrase matches at all, and you are stuck with a phrase being treated as unordered keywords). A good example of why simple indexing is bad is the search facility for the FreeBSD mailing list archives. The facility that's there is better than nothing, but it's unfortunately less useful than google (for example) when looking up specific topics and issues (e.g. try and find the OpenVRRP FreeBSD VRRP implementation via the mailing list search -- it's in there: google found it, but the local search engine didn't). -- Terry To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message