cvs commit: doc/en_US.ISO8859-1/books/handbook book.sgml

[Marc Fonvieille]

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
> > 
> >   FreeBSD doc repository
> > 
> >   Modified files:
> >     en_US.ISO8859-1/books/handbook book.sgml 
> >   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 documentation
> >   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/
> 
> 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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-all/attachments/20051219/65160cdc/attachment.bin