Re: organic documentation

2002-05-06 Thread JJ Behrens
Well, I humbly submit that we should kill this thread :) The original poster's question was easily solved by reading the handbook. Furthermore, we have come to no concensus on improvements to the handbook (e.g. wiki, etc.). Hence, I propose we backburner this topic until a situation arises where

Re: organic documentation

2002-05-03 Thread Bakul Shah
Terry Lambert writes: > 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 y

Re: organic documentation

2002-05-03 Thread Terry Lambert
"R. David Murray" wrote: > Sorry for dropping in to the middle of a conversation, but this > comment puzzles me. I fail to see how: > > handbook + per-page comments from readers > > is *inferior* to: > >handbook with no comments > > given that the handbook maintainers do not have infina

Re: organic documentation

2002-05-03 Thread Terry Lambert
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

Re: organic documentation

2002-05-03 Thread Bakul Shah
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

Re: organic documentation

2002-05-03 Thread David Schultz
Thus spake R. David Murray <[EMAIL PROTECTED]>: > On Fri, 3 May 2002, Terry Lambert 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