Date: Fri, 07 Oct 2011 14:32:37 -0400 From: Glen Barber <gjb@FreeBSD.org> To: =?UTF-8?B?VWxyaWNoIFNww7ZybGVpbg==?= <uqs@FreeBSD.org> Cc: doceng@FreeBSD.org, Niclas Zeising <niclas.zeising@gmail.com>, doc@FreeBSD.org Subject: Re: Conversion to SVN Message-ID: <4E8F45C5.1020106@FreeBSD.org> In-Reply-To: <20111007173808.GK26743@acme.spoerlein.net> References: <20111007141312.GJ26743@acme.spoerlein.net> <4E8F1BE1.7080003@FreeBSD.org> <4E8F2873.80602@gmail.com> <20111007173808.GK26743@acme.spoerlein.net>
next in thread | previous in thread | raw e-mail | index | archive | help
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. > <magic>Starting with 9.0 you need to use baz.</magic> > 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4E8F45C5.1020106>