From owner-cvs-doc@FreeBSD.ORG Mon Dec 19 12:21:35 2005 Return-Path: X-Original-To: cvs-doc@FreeBSD.org Delivered-To: cvs-doc@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EC34116A41F; Mon, 19 Dec 2005 12:21:35 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id C9BB743D49; Mon, 19 Dec 2005 12:21:34 +0000 (GMT) (envelope-from marc@blackend.org) Received: from gothic.blackend.org (gothic.blackend.org [192.168.1.203]) by abigail.blackend.org (8.13.3/8.13.3) with ESMTP id jBJCLWSJ006767; Mon, 19 Dec 2005 13:21:32 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: from gothic.blackend.org (localhost.blackend.org [127.0.0.1]) by gothic.blackend.org (8.13.4/8.13.3) with ESMTP id jBJCLWhK001038; Mon, 19 Dec 2005 13:21:32 +0100 (CET) (envelope-from marc@gothic.blackend.org) Received: (from marc@localhost) by gothic.blackend.org (8.13.4/8.13.3/Submit) id jBJCLWpu001037; Mon, 19 Dec 2005 13:21:32 +0100 (CET) (envelope-from marc) Date: Mon, 19 Dec 2005 13:21:31 +0100 From: Marc Fonvieille To: Ceri Davies , Marc Fonvieille , doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org, remko@FreeBSD.org Message-ID: <20051219122131.GB687@gothic.blackend.org> References: <200512181702.jBIH2wc5003662@repoman.freebsd.org> <20051219115726.GB63860@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="VbJkn9YxBvnuCH5J" Content-Disposition: inline In-Reply-To: <20051219115726.GB63860@submonkey.net> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 6.0-STABLE User-Agent: Mutt/1.5.11 Cc: Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook book.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Dec 2005 12:21:36 -0000 --VbJkn9YxBvnuCH5J Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Dec 19, 2005 at 11:57:27AM +0000, Ceri Davies wrote: > On Sun, Dec 18, 2005 at 05:02:58PM +0000, Marc Fonvieille wrote: > > blackend 2005-12-18 17:02:58 UTC > >=20 > > FreeBSD doc repository > >=20 > > Modified files: > > en_US.ISO8859-1/books/handbook book.sgml=20 > > Log: > > Add a link to previous versions of the Handbook > > (http://docs.FreeBSD.org/doc/). This should be an answer to various > > headaches when it's time to maintain the correctness of a documentati= on > > for the various branches. The Handbook currently covers the use of > > FreeBSD 5.4-RELEASE and FreeBSD 6.0-RELEASE (and 7-CURRENT since now = the > > changes between branches will be less "important"), so the users of > > previous releases should read the versions archived on > > http://docs.FreeBSD.org/doc/ >=20 > So we can start removing all the "if you have 4.x do this, else do that" > in favour of "do that" now? Brilliant! > Most of time: yes. I think when it's not possible to just add a little note for 4.X, we should not loose our time trying to make the doc 4.X compliant. On another hand, if we have a note or a "(on FreeBSD 4.X use blahblah instead)" we can keep them since it does not hurt. For the rest, during a section rewritting (to make it totally 5.X/6.X compliant) we can drop legacy 4.X. In fact, I let it to each committer opinion, and as everyone I think making the doc 5.X/6.X compliant is more important than just removing 4.X parts. Regarding the outdating parts or lacks, we (doceng@) currently trying to write a TODO list to sum up the needs. I should post it soon, well if the holidays are not eating all my free time :) Marc --VbJkn9YxBvnuCH5J Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (FreeBSD) iD8DBQFDpqXLzQ9RwE+OdOgRAhKxAKCFvyGQ0CLplz2Qn16BQEJsGDN6lgCfZOwl KcfDgdc2DwhOUuG6ufdkRas= =oryR -----END PGP SIGNATURE----- --VbJkn9YxBvnuCH5J--