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 > > > > > > 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.
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 -- Only two things are infinite, the universe and human stupidity, and I'm not sure about the former. -- Einstein (attrib.)
pgpEHAiFpU32A.pgp
Description: PGP signature
