Date: Sat, 15 Oct 2005 17:32:07 +0200 From: Marc Fonvieille <blackend@FreeBSD.org> To: Ceri Davies <ceri@submonkey.net>, Remko Lodder <remko@FreeBSD.org>, Tom Rhodes <trhodes@FreeBSD.org>, Joel Dahl <joel@FreeBSD.org>, doc@FreeBSD.org Subject: Re: docs/87445: comments for improvement of handbook/kernelconfig-config.html Message-ID: <20051015153207.GF1202@gothic.blackend.org> In-Reply-To: <20051015130248.GV99170@submonkey.net> References: <200510142331.j9ENV8nA099971@freefall.freebsd.org> <1129364021.653.11.camel@dude.automatvapen.se> <20051015055837.2a3b9035.trhodes@FreeBSD.org> <20051015122036.GT99170@submonkey.net> <20051015123615.GC1202@gothic.blackend.org> <4350FA82.4050201@FreeBSD.org> <20051015130248.GV99170@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
--hYooF8G/hrfVAmum Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Oct 15, 2005 at 02:02:48PM +0100, Ceri Davies wrote: > >=20 > > I am very much in favor of this idea. Though, should we really tag=20 > > another branch? We recently branched the documentation for RELENG6 > > so we might want to just use that? instead of duplicating that > > information. On the other hand, a nice schedule and the availability > > of 'old' unused branches is also very nice. >=20 > I guess that this really would count as "sweeping", which means that > we'll have to wait a week or two. At least that allows us plenty of > time to finalise the plans. >=20 > The important points are: >=20 > i) Handbook-4 must still be available on the website, probably > via the URL /doc/<lang>/handbook4/; >=20 > ii) We must be able to rip out all the [1-4].x information that > is in our way from the current handbook. >=20 > To me, that means: >=20 > i) Laying down a (PRE_)HANDBOOK4 CVS tag; >=20 > ii) Repocopying doc/<lang>/books/handbook to > doc/<lang>/books/handbook4 for each language; > [...] This is not needed. The idea (if I understood well your idea) is to drop 4.X remains from the Handbook, so en_US version needs a tag and localized versions need a branch (if the translation is not complete when handbookX is tagged). All that should be done with a "major release support" schedule in mind. Then if people go on http://www.freebsd.org/releases/4.XR/ part of the web site the 4.X docs should be proposed. On the homepage just the "current" Handbook should be linked, with "current" meaning "the Handbook covering the supported releases." Our current problem is that supporting 6.X, 5.X and 4.X at the same time in our docs is a nightmare. It is not really possible to maintain many versions of the same large doc (book) without headaches, especially for translators (if there are 2 or 3 versions for en_US, it means 4 or 6 versions to work on for the translator: the en_US and the localized versions). So, from my point of view, droping the support is the best/easiest solution but this does not need a repocopy or to have 2 "physical" versions of the same doc. Well, I feel my english sucks today, so my words may be not accurate, I'm sorry for this. Marc --hYooF8G/hrfVAmum Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (FreeBSD) iD8DBQFDUSD2zQ9RwE+OdOgRAjZ3AJ9cdp+Jf0FgDDp6HdSy5I/q0XVZ4wCffX0C 45irdi6qgIUIu0kZ3T+1XQU= =v7sg -----END PGP SIGNATURE----- --hYooF8G/hrfVAmum--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051015153207.GF1202>