From owner-freebsd-hackers@FreeBSD.ORG Tue Dec 20 14:46:54 2005 Return-Path: X-Original-To: hackers@freebsd.org Delivered-To: freebsd-hackers@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A8C4D16A41F for ; Tue, 20 Dec 2005 14:46:54 +0000 (GMT) (envelope-from joel@FreeBSD.org) Received: from av6-1-sn3.vrr.skanova.net (av6-1-sn3.vrr.skanova.net [81.228.9.179]) by mx1.FreeBSD.org (Postfix) with ESMTP id B88D743D46 for ; Tue, 20 Dec 2005 14:46:53 +0000 (GMT) (envelope-from joel@FreeBSD.org) Received: by av6-1-sn3.vrr.skanova.net (Postfix, from userid 502) id 7D575380FA; Tue, 20 Dec 2005 15:46:52 +0100 (CET) Received: from smtp3-1-sn3.vrr.skanova.net (smtp3-1-sn3.vrr.skanova.net [81.228.9.101]) by av6-1-sn3.vrr.skanova.net (Postfix) with ESMTP id 36D82380FE; Tue, 20 Dec 2005 15:46:52 +0100 (CET) Received: from t6o55p111.telia.com (t6o55p111.telia.com [212.181.194.231]) by smtp3-1-sn3.vrr.skanova.net (Postfix) with ESMTP id 9F60237E50; Tue, 20 Dec 2005 15:46:42 +0100 (CET) From: Joel Dahl To: Ceri Davies In-Reply-To: <20051220142254.GD68989@submonkey.net> References: <43A26FFB.9080405@samsco.org> <200512190934.jBJ9YNhX022376@musashi.et.bocholt.fh-gelsenkirchen.de> <20051220142254.GD68989@submonkey.net> Content-Type: text/plain Date: Tue, 20 Dec 2005 15:46:53 +0100 Message-Id: <1135090013.664.56.camel@dude.automatvapen.se> Mime-Version: 1.0 X-Mailer: Evolution 2.2.3 FreeBSD GNOME Team Port Content-Transfer-Encoding: 7bit Cc: Scott Long , hackers@freebsd.org, Dirk GOUDERS Subject: Re: My wish list for 6.1 X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Dec 2005 14:46:54 -0000 On Tue, 2005-12-20 at 14:22 +0000, Ceri Davies wrote: > On Mon, Dec 19, 2005 at 10:34:23AM +0100, Dirk GOUDERS wrote: > > > > > 3. Full review and update of the install docs, handbook, FAQ, etc. > > > There are sections that are embarrassingly out of date (one section of > > > the handbook apparently states that we only support a single brand of > > > wifi cards). A co-worker of mine tried to install 6.0 using just the > > > handbook install guide, and discovered that it really doesn't match > > > reality anymore, in both big and small ways. Contact me directly if > > > you would like his list of comments. > > > > I am wondering if it wouldn't be advantageous to have "versioned" > > documents that just cover one specific release and not to cover all > > realeases in single documents. > > > > I could imagine that it is harder to cover everything in single > > documents than to perhaps copy the existing documentation when a new > > branch is created and edit it to match just the new release. > > > > Maybe, I do not realize how much more work this would be but it would > > probably enforce regular reviews of the documentation and the readers > > would benefit from it. > > This is exactly the idea that I have been pimping to anyone who will > listen for the last three months or so. I also think that it is > advantageous for users who are using, say 4.2, to be able to find > documentation for 4.2 without having to interpret a nest of "if you have > 4.x do this, if 5.0 through 5.3 do that, else do the other". I don't > think it's a lot of work to just branch the handbook (and FAQ > if we decide to keep it) - in fact, for me, it would be a definite win - > at release time, but it just doesn't seem to be what other people want > done. Yep, I really like this. The current mess is impossible to maintain (and also impossible to read). Yesterday I tried to update the kernel configuration chapter to cover 6.0, but I gave up since there are "do this for 4.X, do that for 5.X, and maybe this too for 6.X" everywhere. -- Joel - joel at FreeBSD dot org