Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 4 Aug 2000 22:39:45 -0700
From:      "Jeff Blaine" <jeffblaine@mediaone.net>
To:        <freebsd-doc@freebsd.org>
Subject:   Handbook per -RELEASE
Message-ID:  <004901bffe9f$8ff7cc60$02a8a8c0@ne.mediaone.net>

next in thread | raw e-mail | index | archive | help
Hi folks,

Has the group ever considered (seems likely) the idea of making
version-specific handbooks for -RELEASE versions?

Seems daunting, but at the same time, a Handbook that has
outdated information (that is, not checked for sanity with
the latest release) or is sprinkled with version-specific
sidenotes could possibly be as much work to deal with as
doing version-specific handbooks... (wow, that was SO clear).

Obviously the latest release version's handbook would get
the most effort as (for example) I imagine the 3.x OSes
match pretty well with the current handbook.

Once I get my FreeBSD box to stop crashing every few hours
(*cough*), I intend to start poking around with the tools
and such, and maybe, someday, I'll be able to contribute
to all of this (regardless of the outcome of version-specific
handbooks of course).  I've always been a documentation
fiend, have done stuff in LinuxDoc-SGML before (I know it's
not the same as what you're doing), have been meaning to dive
into DocBook goop...etc...

So, thoughts...hmm, well, to release a version-specific handbook
_with_ the actual OS (which seems like the right thing to do), a
good amount of doc people would have to be following -CURRENT
(I guess?).  Pretty sane that the previous version's handbook
would be used as a starting point and then just gone through
chapter by chapter to check for accuracy and such...

Anyway, just a thought.



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?004901bffe9f$8ff7cc60$02a8a8c0>