From owner-freebsd-hackers@FreeBSD.ORG  Mon Dec 19 09:34:36 2005
Return-Path: <owner-freebsd-hackers@FreeBSD.ORG>
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 DC42F16A41F
	for <hackers@freebsd.org>; Mon, 19 Dec 2005 09:34:36 +0000 (GMT)
	(envelope-from gouders@et.bocholt.fh-gelsenkirchen.de)
Received: from alice.et.bocholt.fh-gelsenkirchen.de
	(alice.et.bocholt.fh-gelsenkirchen.de [193.175.197.63])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 11D3743D45
	for <hackers@freebsd.org>; Mon, 19 Dec 2005 09:34:34 +0000 (GMT)
	(envelope-from gouders@et.bocholt.fh-gelsenkirchen.de)
Received: from musashi.et.bocholt.fh-gelsenkirchen.de
	(musashi.et.bocholt.fh-gelsenkirchen.de [193.175.197.95])
	by alice.et.bocholt.fh-gelsenkirchen.de (8.12.9/8.12.9) with ESMTP id
	jBJ9YVmF011871
	(version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO);
	Mon, 19 Dec 2005 10:34:32 +0100
Received: from localhost (localhost [127.0.0.1])
	by musashi.et.bocholt.fh-gelsenkirchen.de (8.13.3/8.13.3) with ESMTP id
	jBJ9YNhX022376; Mon, 19 Dec 2005 10:34:28 +0100 (CET)
	(envelope-from hank@musashi.et.bocholt.fh-gelsenkirchen.de)
Message-Id: <200512190934.jBJ9YNhX022376@musashi.et.bocholt.fh-gelsenkirchen.de>
To: Scott Long <scottl@samsco.org>
In-Reply-To: Message from Scott Long <scottl@samsco.org> 
	of "Fri, 16 Dec 2005 00:42:51 MST." <43A26FFB.9080405@samsco.org> 
Date: Mon, 19 Dec 2005 10:34:23 +0100
From: Dirk GOUDERS <gouders@et.bocholt.fh-ge.de>
X-Scanned-By: MIMEDefang 2.43
Cc: hackers@freebsd.org
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
	<freebsd-hackers.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-hackers>, 
	<mailto:freebsd-hackers-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-hackers>
List-Post: <mailto:freebsd-hackers@freebsd.org>
List-Help: <mailto:freebsd-hackers-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-hackers>,
	<mailto:freebsd-hackers-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 19 Dec 2005 09:34:37 -0000


> 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.

Dirk