From owner-freebsd-doc Fri Aug 4 19:39:11 2000 Delivered-To: freebsd-doc@freebsd.org Received: from chmls06.mediaone.net (chmls06.mediaone.net [24.147.1.144]) by hub.freebsd.org (Postfix) with ESMTP id 274C837B6BB for ; Fri, 4 Aug 2000 19:39:08 -0700 (PDT) (envelope-from jeffblaine@mediaone.net) Received: from nollie (kickflop.ne.mediaone.net [24.91.56.150]) by chmls06.mediaone.net (8.8.7/8.8.7) with SMTP id WAA25353 for ; Fri, 4 Aug 2000 22:39:06 -0400 (EDT) Message-ID: <004901bffe9f$8ff7cc60$02a8a8c0@ne.mediaone.net> From: "Jeff Blaine" To: Subject: Handbook per -RELEASE Date: Fri, 4 Aug 2000 22:39:45 -0700 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.00.2615.200 X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2615.200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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