38 messages in org.freebsd.freebsd-stableRe: organic documentation | From | Sent On | Attachments |
|---|---|---|
| Dave Hayes | May 2, 2002 1:47 pm | |
| Terry Lambert | May 2, 2002 2:16 pm | |
| Bruce A. Mah | May 2, 2002 2:18 pm | |
| Bruce A. Mah | May 2, 2002 2:28 pm | |
| Archie Cobbs | May 2, 2002 2:29 pm | |
| Terry Lambert | May 2, 2002 3:02 pm | |
| Drew Tomlinson | May 2, 2002 3:15 pm | |
| Bruce A. Mah | May 2, 2002 3:17 pm | |
| Brooks Davis | May 2, 2002 3:25 pm | |
| Terry Lambert | May 2, 2002 3:37 pm | |
| Aragon Gouveia | May 2, 2002 3:46 pm | |
| Terry Lambert | May 2, 2002 3:46 pm | |
| Drew Tomlinson | May 2, 2002 3:57 pm | |
| Bruce A. Mah | May 2, 2002 3:58 pm | |
| Chris Faulhaber | May 2, 2002 4:02 pm | |
| Terry Lambert | May 2, 2002 4:11 pm | |
| Craig Boston | May 2, 2002 4:12 pm | |
| Bruce A. Mah | May 2, 2002 4:17 pm | |
| Garance A Drosihn | May 2, 2002 7:09 pm | |
| Dave Hayes | May 2, 2002 8:43 pm | |
| Brooks Davis | May 2, 2002 9:23 pm | |
| Michael Sierchio | May 2, 2002 10:03 pm | |
| Kosta K | May 2, 2002 10:20 pm | |
| Brooks Davis | May 2, 2002 10:27 pm | |
| Dave Hayes | May 2, 2002 11:37 pm | |
| Thomas Seck | May 3, 2002 2:44 am | |
| Brian T.Schellenberger | May 3, 2002 6:14 am | |
| Michael Sierchio | May 3, 2002 9:18 am | |
| Steve O'Hara-Smith | May 3, 2002 10:20 am | |
| JJ Behrens | May 3, 2002 11:15 am | |
| Terry Lambert | May 3, 2002 11:20 am | |
| R. David Murray | May 3, 2002 11:34 am | |
| David Schultz | May 3, 2002 1:27 pm | |
| Lou Katz | May 3, 2002 2:23 pm | |
| Bakul Shah | May 3, 2002 4:45 pm | |
| Terry Lambert | May 3, 2002 5:02 pm | |
| Terry Lambert | May 3, 2002 5:11 pm | |
| JJ Behrens | May 6, 2002 11:26 am |
| Subject: | Re: organic documentation | |
|---|---|---|
| From: | Bakul Shah (bak...@bitblocks.com) | |
| Date: | May 3, 2002 4:45:50 pm | |
| List: | org.freebsd.freebsd-stable | |
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 majo...@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message