From owner-freebsd-doc@FreeBSD.ORG Fri Oct 7 16:27:33 2011 Return-Path: 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 C072F1065673; Fri, 7 Oct 2011 16:27:33 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from mail.lysator.liu.se (mail.lysator.liu.se [IPv6:2001:6b0:17:f0a0::3]) by mx1.freebsd.org (Postfix) with ESMTP id 4F5CF8FC17; Fri, 7 Oct 2011 16:27:33 +0000 (UTC) Received: from mail.lysator.liu.se (localhost [127.0.0.1]) by mail.lysator.liu.se (Postfix) with ESMTP id A1EA24001E; Fri, 7 Oct 2011 18:27:32 +0200 (CEST) Received: by mail.lysator.liu.se (Postfix, from userid 1004) id 96E414001F; Fri, 7 Oct 2011 18:27:32 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on bernadotte.lysator.liu.se X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=FREEMAIL_FROM autolearn=disabled version=3.3.1 X-Spam-Score: 0.0 Received: from mx.daemonic.se (mx.daemonic.se [IPv6:2001:470:dca9:0:1::3]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.lysator.liu.se (Postfix) with ESMTPSA id 2BED54001E; Fri, 7 Oct 2011 18:27:32 +0200 (CEST) Received: from mail.daemonic.se (mail.daemonic.se [IPv6:2001:470:dca9:0:1::4]) by mx.daemonic.se (Postfix) with ESMTPS id 030FC119C04; Fri, 7 Oct 2011 18:27:32 +0200 (CEST) Received: from tifa.daemonic.se (ip212-238-39-201.hotspotsvankpn.com [212.238.39.201]) by mail.daemonic.se (Postfix) with ESMTPSA id D359512B0A0; Fri, 7 Oct 2011 18:27:31 +0200 (CEST) Received: from tifa.daemonic.se (localhost [127.0.0.1]) by tifa.daemonic.se (Postfix) with ESMTP id 410A333; Fri, 7 Oct 2011 18:27:31 +0200 (CEST) Message-ID: <4E8F2873.80602@gmail.com> Date: Fri, 07 Oct 2011 18:27:31 +0200 From: Niclas Zeising User-Agent: Mutt/1.5.21 MIME-Version: 1.0 To: Glen Barber References: <20111007141312.GJ26743@acme.spoerlein.net> <4E8F1BE1.7080003@FreeBSD.org> In-Reply-To: <4E8F1BE1.7080003@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit X-Virus-Scanned: ClamAV using ClamSMTP Cc: doceng@FreeBSD.org, doc@FreeBSD.org, =?ISO-8859-1?Q?Ulrich_Sp=F6rlein?= Subject: Re: Conversion to SVN 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: Fri, 07 Oct 2011 16:27:33 -0000 On 10/07/11 17:33, Glen Barber wrote: > Hi, > > On 10/7/11 10:13 AM, Ulrich Spörlein wrote: >> What I, personally, would like to see is us using the same svn repo as >> src. That means we would have to stop svn.freebsd.org for the >> conversion, turn off email sending, dump 50k revisions into it (under >> /doc and /www perhaps? where should branches/tags end up?), then turn >> everything back on. >> > > The following is something that I have been kicking around in my head > for quite some time, but haven't found the right time to bring it up: > > What I would like to see "someday" is a development workflow that more > closely matches src. > > What do I mean by that? > > I think it would be beneficial to provide a "versioned" FreeBSD > Handbook. The PostgreSQL documentation folks do this [1] - you can find > documentation that was specific to a particular release, so you can > determine if something you have found in the docs appropriately matches > the version you are running. [2] > > A bigger reason I think this would be a good thing is actually a rather > obvious one: those of us (doc folks) tracking -CURRENT can document > things as they happen. More specifically, we would not have to wait > until we are nearing a release to begin updating documentation that is > relevant to that release. This way, doc/www HEAD (well, not necessarily > www for this case...) would be as up-to-date as possible with -CURRENT, > which I believe will benefit all of us (especially our users) when > release time is near. > > I have not yet put much more thought into the layout. As I said, I was > waiting for the "right time" to bring this up and ask for opinions, > feedback, etc. Since the topic of moving to subversion has been brought > up, now seems to be as good a time as any, since this would probably be > easier to juggle with subversion. > > [1] - http://www.postgresql.org/docs/ > [2] - For the record, yes, I am volunteering to do the work that would > be required to make this happen, too. > > Just my $0.02. :-) > I don't care very much about whether we use the existing svn repo or not, as long as we get one. Using a versioned handbook (and possibly other docs as well) sounds like a really good idea, and I don't think it will incur that much administrative overhead for either us doc people nor the freebsd.org admins. This will also make it possible to rip out some old stuff from the current handbook (such as ISDN information) and just point people to earlier handbooks where it is present, thus making the handbook more closely match what is in the release it tries to document. Best regards! -- Niclas Zeising