From owner-freebsd-doc@FreeBSD.ORG  Fri Sep  3 13:04:32 2010
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 5097A10657F4;
	Fri,  3 Sep 2010 13:04:32 +0000 (UTC) (envelope-from danger@rulez.sk)
Received: from services.syscare.sk (services.syscare.sk [188.40.39.36])
	by mx1.freebsd.org (Postfix) with ESMTP id 0676B8FC0C;
	Fri,  3 Sep 2010 13:04:31 +0000 (UTC)
Received: from services.syscare.sk (services [188.40.39.36])
	by services.syscare.sk (Postfix) with ESMTP id 04F58415BC;
	Fri,  3 Sep 2010 15:04:31 +0200 (CEST)
X-Virus-Scanned: amavisd-new at rulez.sk
Received: from services.syscare.sk ([188.40.39.36])
	by services.syscare.sk (services.rulez.sk [188.40.39.36]) (amavisd-new,
	port 10024)
	with ESMTP id 1471jSM6ltWW; Fri,  3 Sep 2010 15:04:29 +0200 (CEST)
Received: from [192.168.1.2] (unknown [189.72.205.172])
	(using TLSv1 with cipher AES128-SHA (128/128 bits))
	(No client certificate requested)
	(Authenticated sender: danger@rulez.sk)
	by services.syscare.sk (Postfix) with ESMTPSA id 832D7415A0;
	Fri,  3 Sep 2010 15:04:28 +0200 (CEST)
References: <AANLkTim=VBiPgEpo=j6BVxHRB2on+caJaGHsUwzGoBao@mail.gmail.com>
	<AANLkTinVhbb3aK+KCEe_4Y7kx00844HW7pktmJwPnR+j@mail.gmail.com>
	<20100902080219.GH64651@hoeg.nl>
	<45764F17-2279-4520-93D7-8F0B8BE991DE@rulez.sk>
	<AANLkTim-60+TeBRdK8hMCVQihq1hTNwwPkoU87H5+aDN@mail.gmail.com>
In-Reply-To: <AANLkTim-60+TeBRdK8hMCVQihq1hTNwwPkoU87H5+aDN@mail.gmail.com>
Mime-Version: 1.0 (iPod Mail 8A293)
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii
Message-Id: <95629F52-ADF7-4D96-8153-4C9C4E894780@rulez.sk>
X-Mailer: iPod Mail (8A293)
From: Daniel Gerzo <danger@rulez.sk>
Date: Fri, 3 Sep 2010 10:04:04 -0300
To: Adam Vande More <amvandemore@gmail.com>
Cc: Ed Schouten <ed@80386.nl>, "doc@freebsd.org" <doc@freebsd.org>,
	"current@freebsd.org" <current@freebsd.org>
Subject: Re: Call for Documentation Contributors
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 03 Sep 2010 13:04:32 -0000


On 3.9.2010, at 1:10, Adam Vande More <amvandemore@gmail.com> wrote:

>>=20
> Wouldn't it be a lot easier to have a nice article on installing
> /usr/ports/misc/freebsd-doc-* from the date of the release of the installe=
d
> system?  Or maybe offer archive web access to a handbook snapshot from tha=
t
> date(Django does something similar)?

FYI we have archive of hadbooks and FAQs for past releases at http://docs.fr=
eebsd.org/doc/. People just often don't know or are lazy to browse there, ev=
en though I believe it is linked from the footer of the handbook. The proble=
m here is that we happen to cover all the supported releases in a single han=
dbook which simply leads to confusion...on the other hand you may be right t=
hat discrepancies don't happen that often and the additional work is not wor=
th it.

> Maintaining separate handbook  branches
> seems unrealistic if there aren't enough doc contributors to maintain one t=
o
> expectations, and IME discrepancies aren't very frequent.