From owner-freebsd-hackers Mon May 6 11:27:56 2002 Delivered-To: freebsd-hackers@freebsd.org Received: from alicia.nttmcl.com (alicia.nttmcl.com [216.69.69.10]) by hub.freebsd.org (Postfix) with ESMTP id 0BC5A37B403; Mon, 6 May 2002 11:27:44 -0700 (PDT) Received: (from jj@localhost) by alicia.nttmcl.com (8.10.1/8.10.1) id g46IQiv18127; Mon, 6 May 2002 11:26:44 -0700 (PDT) Date: Mon, 6 May 2002 11:26:44 -0700 From: JJ Behrens To: Terry Lambert , Dave Hayes , Brooks Davis , Michael Sierchio , Drew Tomlinson , bmah@FreeBSD.ORG, freebsd-hackers@FreeBSD.ORG, freebsd-stable@FreeBSD.ORG Subject: Re: organic documentation Message-ID: <20020506112644.A17574@alicia.nttmcl.com> Mail-Followup-To: JJ Behrens , Terry Lambert , Dave Hayes , Brooks Davis , Michael Sierchio , Drew Tomlinson , bmah@FreeBSD.ORG, freebsd-hackers@FreeBSD.ORG, freebsd-stable@FreeBSD.ORG References: <20020503142917.H32803-100000@twirl.bitdance.com> <3CD3273B.1D8F54F4@mindspring.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <3CD3273B.1D8F54F4@mindspring.com>; from tlambert2@mindspring.com on Fri, May 03, 2002 at 05:11:39PM -0700 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 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 something like wiki turns out to be more helpful than just the handbook alone. My $0.02 :) -jj > "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 infinate time > > to polish the handbook, nor infinate knowledge about the > > quirks discoverd by the community. > > 1) Qualification of sources of information. Not every > commenting reader is adding something other than > "First Post! Nyah!". > > 2) Classification varies by individual; to present a > coherent whole, not everyone can be an editor. This > is why published collections of works have editors: > to apply a uniform standard. > > 3) Disinformatoin is not discernable from information. > > Consider a dictionary created via a wiki: > > o Some people could order their entries by length, while > others could order them alphabetically; > > o Is the Schlossen before or after the character "S", > lexically? > > o Who checks the facts? > > o Copyright assignmnet (I guess you could "shrink wrap" > this). > > > > Good comments could be properly classified and incorporated into > > the text as the maintainers have time. > > So you need an editor. I guess you are suggesting that they > would be incorporated into the handbook itself? > > > > On the other hand, I *can* see that it might be a non-trivial > > project to integrate the documentation system with a web > > comment system such that the two do not interfere with each other. > > A web comment system will interfere. It can't help it. -- Users of C++ should consider hanging themselves rather than shooting their legs off--it's best not to use C++ simply as a better C. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message