From owner-freebsd-hackers Fri May 3 11:17:20 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 09B6037B422; Fri, 3 May 2002 11:16:52 -0700 (PDT) Received: (from jj@localhost) by alicia.nttmcl.com (8.10.1/8.10.1) id g43IFwS04551; Fri, 3 May 2002 11:15:58 -0700 (PDT) Date: Fri, 3 May 2002 11:15:58 -0700 From: JJ Behrens To: Dave Hayes , Brooks Davis , Michael Sierchio , Terry Lambert , Drew Tomlinson , bmah@FreeBSD.ORG, freebsd-hackers@FreeBSD.ORG, freebsd-stable@FreeBSD.ORG Subject: Re: Difference between RELENG_* and RELENG_*_BP Message-ID: <20020503111558.A2534@alicia.nttmcl.com> Mail-Followup-To: JJ Behrens , Dave Hayes , Brooks Davis , Michael Sierchio , Terry Lambert , Drew Tomlinson , bmah@FreeBSD.ORG, freebsd-hackers@FreeBSD.ORG, freebsd-stable@FreeBSD.ORG References: <200205030637.g436bab89675@hokkshideh2.jetcafe.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200205030637.g436bab89675@hokkshideh2.jetcafe.org>; from dave@jetcafe.org on Thu, May 02, 2002 at 11:37:31PM -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 > All this dovetails with something I expressed earlier, with regards to > annotating documentation. Somehow, this community needs to be able to > process a certan class of ideas in a format other than linear mailing > lists. Perhaps some sort of meta-document is needed which describes > how things currently work, and some sort of attachable discussion > needs to go with ideas in that document. Perhaps this is the handbook? > > I don't have a completely clear picture yet. Maybe some of you can > help me get one? =) 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. To critique myself, in this particular situation, the handbook details the that -STABLE isn't stable very well in section 19.2.2 (I'm always impressed by how nice the handbook is). However, user comments at the end might be nice to explain why this branch has historically been called stable, and why it'd be too difficult to change the name. If there's a general concensus that this would be a good idea, I'd be willing to help make it happen. -jj -- 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