From owner-freebsd-doc@FreeBSD.ORG Fri Oct 7 18:32:40 2011 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1CCEC1065675 for ; Fri, 7 Oct 2011 18:32:40 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 9E5AA8FC13 for ; Fri, 7 Oct 2011 18:32:39 +0000 (UTC) Received: (qmail 47221 invoked by uid 0); 7 Oct 2011 14:32:38 -0400 Received: from unknown (HELO schism.local) (gjb@75.146.225.65) by 0 with SMTP; 7 Oct 2011 14:32:38 -0400 Message-ID: <4E8F45C5.1020106@FreeBSD.org> Date: Fri, 07 Oct 2011 14:32:37 -0400 From: Glen Barber User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:7.0.1) Gecko/20110929 Thunderbird/7.0.1 MIME-Version: 1.0 To: =?UTF-8?B?VWxyaWNoIFNww7ZybGVpbg==?= References: <20111007141312.GJ26743@acme.spoerlein.net> <4E8F1BE1.7080003@FreeBSD.org> <4E8F2873.80602@gmail.com> <20111007173808.GK26743@acme.spoerlein.net> In-Reply-To: <20111007173808.GK26743@acme.spoerlein.net> X-Enigmail-Version: 1.3.2 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: doceng@FreeBSD.org, Niclas Zeising , doc@FreeBSD.org Subject: Re: Conversion to SVN X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 Oct 2011 18:32:40 -0000 On 10/7/11 1:38 PM, Ulrich Spörlein wrote: >>> I think it would be beneficial to provide a "versioned" FreeBSD >>> Handbook. The PostgreSQL documentation folks do this [1] - you can find >>> documentation that was specific to a particular release, so you can >>> determine if something you have found in the docs appropriately matches >>> the version you are running. [2] >>> > > I have no good idea on how to fit stuff like -CURRENT becoming a release > into this scheme, however. With a versioned Handbook, we can publish the version for -CURRENT as well as the supported releases. This can get more eyes on what _will_ be released with regards to the documentation, get outdated content issues resolved prior to the release, and lessen the influx of doc PRs post-release. > Perhaps some special tags can be introduced that only make content visible, > once we have released 9.0. We already have this. See www/share/sgml/release.ent and www/en/where.sgml for a good example, specifically the "Help Test" section of where.sgml. > That way you can write > > On FreeBSD 6.0 and below you have to use foo. > On versions 7.x and 8.x you need to do bar. > Starting with 9.0 you need to use baz. > This is exactly what I'd like to be able to stop doing, particularly in large chapters. But, that's all I'll say about it for now, because it's not directly related to the original post. Just pointing out I'd like to see a move to svn, as well, while giving a developmental reason why. Regards, Glen -- Glen Barber | gjb@FreeBSD.org FreeBSD Documentation Project