From owner-freebsd-hackers Fri May 3 17:11:27 2002 Delivered-To: freebsd-hackers@freebsd.org Received: from ussenterprise.ufp.org (ussenterprise.ufp.org [208.185.30.210]) by hub.freebsd.org (Postfix) with ESMTP id 5EB2237B405 for ; Fri, 3 May 2002 17:11:22 -0700 (PDT) Received: (from bicknell@localhost) by ussenterprise.ufp.org (8.11.1/8.11.1) id g440BLf03595 for freebsd-hackers@FreeBSD.ORG; Fri, 3 May 2002 20:11:21 -0400 (EDT) (envelope-from bicknell) Date: Fri, 3 May 2002 20:11:21 -0400 From: Leo Bicknell To: freebsd-hackers@FreeBSD.ORG Subject: Re: Difference between RELENG_* and RELENG_*_BP Message-ID: <20020504001121.GA3310@ussenterprise.ufp.org> Mail-Followup-To: freebsd-hackers@FreeBSD.ORG References: <200205030637.g436bab89675@hokkshideh2.jetcafe.org> <20020503111558.A2534@alicia.nttmcl.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020503111558.A2534@alicia.nttmcl.com> Organization: United Federation of Planets 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 In a message written on Fri, May 03, 2002 at 11:15:58AM -0700, JJ Behrens wrote: > The online documentation for PHP allows users to post comments at the end of > 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. Allowing random comments (alone) isn't useful. More often than not PHP comments are not useful, or outright wrong. That said, we need to break down the barriers to good documentation. I think we could learn something from slashdot.org here, in that the right solution might be not only to have comments, but also to have moderators. In this way the user community can not only submit comments, but also rank them so we separate the wheat from the chaff. In the case of documentation it would also be essential to remove highly moderated comments as they are integrated into the documentation. At the end of the day, we need to lower the barrier to adding documentation, while increasing the quality. Far from an easy task. -- Leo Bicknell - bicknell@ufp.org - CCIE 3440 PGP keys at http://www.ufp.org/~bicknell/ Read TMBG List - tmbg-list-request@tmbg.org, www.tmbg.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message