Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 19 Dec 2005 12:28:45 +0000
From:      Ceri Davies <ceri@submonkey.net>
To:        Marc Fonvieille <blackend@FreeBSD.org>
Cc:        remko@FreeBSD.org, doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/books/handbook book.sgml
Message-ID:  <20051219122845.GC63860@submonkey.net>
In-Reply-To: <20051219122131.GB687@gothic.blackend.org>
References:  <200512181702.jBIH2wc5003662@repoman.freebsd.org> <20051219115726.GB63860@submonkey.net> <20051219122131.GB687@gothic.blackend.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--DIOMP1UsTsWJauNi
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Dec 19, 2005 at 01:21:31PM +0100, Marc Fonvieille wrote:
> 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 documenta=
tion
> > >   for the various branches.  The Handbook currently covers the use of
> > >   FreeBSD 5.4-RELEASE and FreeBSD 6.0-RELEASE (and 7-CURRENT since no=
w 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!
> >
>=20
> 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.

OK, that makes sense.

> 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 :)

Yeah, I know that feeling :)

Ceri
--=20
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former.			  -- Einstein (attrib.)

--DIOMP1UsTsWJauNi
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (FreeBSD)

iD8DBQFDpqd8ocfcwTS3JF8RAmMKAKDKnq5DZbFFBJEz6FoQs1HaDUCmeACfWq02
c4oqbm4pok6ynGCODzTHPrs=
=AX2W
-----END PGP SIGNATURE-----

--DIOMP1UsTsWJauNi--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051219122845.GC63860>