From owner-freebsd-doc@FreeBSD.ORG Fri Sep 3 04:39:54 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 11B3710656AB; Fri, 3 Sep 2010 04:39:54 +0000 (UTC) (envelope-from amvandemore@gmail.com) Received: from mail-fx0-f54.google.com (mail-fx0-f54.google.com [209.85.161.54]) by mx1.freebsd.org (Postfix) with ESMTP id 694BA8FC12; Fri, 3 Sep 2010 04:39:53 +0000 (UTC) Received: by fxm4 with SMTP id 4so967301fxm.13 for <multiple recipients>; Thu, 02 Sep 2010 21:39:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:received:in-reply-to :references:date:message-id:subject:from:to:cc:content-type; bh=80npj9X5rhUhMB2n6muOQ2y3EMslgiHfd3zaQS3sd0Q=; b=oUt9oXjes35V1EpmtjmpuBpFzNr6rxFnCl89yO8T4Uxcpxq+ZkMsjI1jM8fml4zSrL 1zgzKlFxS0aq0i7N1+uXhg1l+W1/ADGg/OUy+otUEYdHglD/r7mBWDi/fQ2+pMNqWhpv U5JEzSaNz9q/25LEwCxUf3ZiYsXwv9eMFx4gU= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; b=JGheYsI1pQKwdhLQsvn5dnGtUOWAmdOuR8oULQ3fJzHN2VywRwlCQBtKCgCsgZCokJ I2qnEwbiCMT914cedKwFOVLRRZpY8quxrXeeQuOG9dcgZxSrOMr8Gpg+if5OdnnMlxGr MLWiE5ohHr2qbVDaZf+nI8wwDsBXpsRYv1uCo= MIME-Version: 1.0 Received: by 10.223.123.199 with SMTP id q7mr71255far.84.1283487056449; Thu, 02 Sep 2010 21:10:56 -0700 (PDT) Received: by 10.223.120.147 with HTTP; Thu, 2 Sep 2010 21:10:56 -0700 (PDT) In-Reply-To: <45764F17-2279-4520-93D7-8F0B8BE991DE@rulez.sk> 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> Date: Thu, 2 Sep 2010 23:10:56 -0500 Message-ID: <AANLkTim-60+TeBRdK8hMCVQihq1hTNwwPkoU87H5+aDN@mail.gmail.com> From: Adam Vande More <amvandemore@gmail.com> To: Daniel Gerzo <danger@rulez.sk> Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 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 04:39:54 -0000 On Thu, Sep 2, 2010 at 5:54 PM, Daniel Gerzo <danger@rulez.sk> wrote: > I actually think there is some point in this idea. The problem is that many > times we just leave notes or warnings specific for given releases, which can > many times lead to confusion (or people just don't notice) and as time goes > and we cut the support for given releases they get stale (e.g. We had many > of those for 5.x). > > We could just maintain the handbook in separate branches like we do with > src, keeping them all built online, and merge relevant things where > appropriate. This will, however, add quite a lot (for my taste) of > additional work for us. > 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 installed system? Or maybe offer archive web access to a handbook snapshot from that date(Django does something similar)? Maintaining separate handbook branches seems unrealistic if there aren't enough doc contributors to maintain one to expectations, and IME discrepancies aren't very frequent. -- Adam Vande More