Date: Fri, 07 Oct 2011 16:25:08 -0700 From: Doug Barton <dougb@FreeBSD.org> To: =?ISO-8859-1?Q?Ulrich_Sp=F6rlein?= <uqs@FreeBSD.org> Cc: Glen Barber <gjb@FreeBSD.org>, Niclas Zeising <niclas.zeising@gmail.com>, doc@FreeBSD.org, doceng@FreeBSD.org Subject: Re: Conversion to SVN Message-ID: <4E8F8A54.6010606@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>
index | next in thread | previous in thread | raw e-mail
On 10/07/2011 10:38, Ulrich Spörlein wrote: > I'm not sure that having a versioned handbook is such a good idea. I'd > rather have one page/one source to go to for looking up how things are > done. You immediately see what has changed between the releases and > don't have to compare docs to see if doing foo on 9.0 works the same as > on 8.3. > > I have no good idea on how to fit stuff like -CURRENT becoming a release > into this scheme, however. Perhaps some special tags can be introduced > that only make content visible, once we have released 9.0. 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> I work with different versions of FreeBSD on a daily basis, so I agree that having all of the information available in one place is a tremendous benefit. But I think that you're on the right track with your "magic tags" idea. I think it would be really cool to have all the info for all the different versions in the same place, and have the default be to include them all; but also have the ability to define something in the environment so that you could include only the relevant bits if you wanted to build the docs for a specific version. Ideally such a system would also include minor versions for those rare situations that we change a methodology within a branch. Of course this is just talk, I don't have the time to actually make this happen unfortunately, but perhaps someone else will be interested/motivated to make it happen? Doug -- Nothin' ever doesn't change, but nothin' changes much. -- OK Go Breadth of IT experience, and depth of knowledge in the DNS. Yours for the right price. :) http://SupersetSolutions.com/home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4E8F8A54.6010606>