From owner-freebsd-doc@FreeBSD.ORG Sun Oct 23 00:03:03 2005 Return-Path: X-Original-To: doc@freebsd.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E410E16A41F; Sun, 23 Oct 2005 00:03:03 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from aiolos.otenet.gr (aiolos.otenet.gr [195.170.0.93]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6539A43D53; Sun, 23 Oct 2005 00:03:02 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from flame.pc (patr530-a083.otenet.gr [212.205.215.83]) by aiolos.otenet.gr (8.13.4/8.13.4/Debian-1) with ESMTP id j9N02vmA008373; Sun, 23 Oct 2005 03:02:58 +0300 Received: from flame.pc (flame [127.0.0.1]) by flame.pc (8.13.4/8.13.4) with ESMTP id j9N01KNn093798; Sun, 23 Oct 2005 03:01:23 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by flame.pc (8.13.4/8.13.4/Submit) id j9MHfnLm001834; Sat, 22 Oct 2005 20:41:49 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Sat, 22 Oct 2005 20:41:49 +0300 From: Giorgos Keramidas To: Ceri Davies , Tom Rhodes , Joel Dahl , doc@freebsd.org Message-ID: <20051022174149.GC1681@flame.pc> References: <200510142331.j9ENV8nA099971@freefall.freebsd.org> <1129364021.653.11.camel@dude.automatvapen.se> <20051015055837.2a3b9035.trhodes@FreeBSD.org> <20051015122036.GT99170@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20051015122036.GT99170@submonkey.net> Cc: Subject: Re: docs/87445: comments for improvement of handbook/kernelconfig-config.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 23 Oct 2005 00:03:04 -0000 On 2005-10-15 13:20, Ceri Davies wrote: > [ Moved to doc@ from some other place ] > > On Sat, Oct 15, 2005 at 05:58:37AM -0400, Tom Rhodes wrote: > > > Or perhaps > > 4.X will be knifed from the handbook. And most likely, the > > only people who will expect it coming will be those that aren't > > going to stand in my way.[1] :) > > > > [1]: Please don't take that as if it's rude, I'm actually > > joking around with it. Cause I know that if someone > > tried that, well, to core && doceng they'd be explaining. > > Actually that's a great idea. There's no reason why we couldn't, like > today, commit a copy of the current handbook to handbook4 and then get > rid of all the crud from the real handbook. Same deal with the FAQ. > The information is still available then, but we no longer have to tear > our own hair own trying to maintain the documents. The main problem with doing this is that it looks a lot like branching the docs, and I think this is something that not many people would like. For instance, what happens with corrections to the 4.X Handbook that people haven't noticed yet? Or what happens when we restructure parts of the HEAD of the Handbook, but fail to do so in Handbooks of earlier FreeBSD versions? Are we supposed to 'MFC' Handbook fixes about grammar, style, or even bugs in the existing examples to Handbook4? I have given a lot of thought to the fact that we are currently sprinkling elements around in a more or less "yeah, put them anywhere you like" manner. This looks & feels a bit wrong. I'm not sure if we can support a fully branched doc/ tree though. It would be nice to have a section of our website that is very similar to what one sees on docs.sun.com: - FreeBSD 4.X documentation set - Articles - Books - Handbook - FreeBSD 5.X documentation set - Articles - Books - Handbook etc. but that is something I've long postponed suggesting for fear of some huge, monstrous bikeshed. If we are to keep separate versions of the Handbook though, why not go all the way and organize the entire doc/ tree around FreeBSD releases? - Giorgos