From owner-freebsd-doc@FreeBSD.ORG Thu Nov 3 21:47:51 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 8046A1065677; Thu, 3 Nov 2011 21:47:51 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from mxout1.bln1.prohost.de (mxout1.bln1.prohost.de [213.160.84.47]) by mx1.freebsd.org (Postfix) with ESMTP id 07E788FC15; Thu, 3 Nov 2011 21:47:50 +0000 (UTC) Received: from Benedicts-Macbook-Pro.local (p4FC72226.dip.t-dialin.net [79.199.34.38]) (authenticated bits=0) by mx1.bln1.prohost.de (8.14.1/8.14.1) with ESMTP id pA3LaphL018199 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 3 Nov 2011 22:36:52 +0100 Message-ID: <4EB3097A.5080506@FreeBSD.org> Date: Thu, 03 Nov 2011 22:36:58 +0100 From: Benedict Reuschling Organization: The FreeBSD Project User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:7.0.1) Gecko/20110929 Thunderbird/7.0.1 MIME-Version: 1.0 To: =?ISO-8859-1?Q?Sp=F6rlein?= References: <20111007141312.GJ26743@acme.spoerlein.net> <201110251405.46493.jhb@freebsd.org> <4EABB0AB.9070808@FreeBSD.org> <201111021421.30777.jhb@freebsd.org> <4EB19BBF.70608@FreeBSD.org> <20111102212600.GC26743@acme.spoerlein.net> In-Reply-To: <20111102212600.GC26743@acme.spoerlein.net> X-Enigmail-Version: 1.3.2 OpenPGP: id=4A819348 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit X-Null-Tag: 794ac18cdcf2b84d00dcf1966517a3ea Cc: Doug Barton , doc@FreeBSD.org, John Baldwin , doceng@FreeBSD.org, freebsd-doc@FreeBSD.org, "Simon L. B. Nielsen" Subject: Re: Conversion to SVN X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: bcr@FreeBSD.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Nov 2011 21:47:51 -0000 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Am 02.11.11 22:26, schrieb Spörlein: > On Wed, 2011-11-02 at 12:36:31 -0700, Doug Barton wrote: >> On 11/02/2011 11:21, John Baldwin wrote: >>> If you really want to do this in the same repo, I won't object. >> >> Just to be clear, I personally do think it's the right design choice, >> sure. But there are also plenty of people who have been talking about >> the benefits that this would bring. It would be nice if some of those >> people speak up now. :) > > 1. One less thing to admin/maintain (and btw, I'm of the opinion we > should get rid of the svn->cvs exporter, but that's another can of > worms) > > 2. Changesets spanning source *and* documentation. > > 3. The possibility to svn mv parts of src into doc and vice versa. Might > actually simplify release building, but I'm not familiar with that. > > 4. Less confusion about what a svn revision number means. With CVS IDs > everybody knew it's about a file. If we would have two or three SVN > repos, then 'r123456' can mean three wildly different things. > Indeed, but we agreed (more or less) that we should put ports into a separate repo (once they do the actual conversion). So even if we agreed on putting doc and src together into one repo, there will still be ambiguity about which revision number has been referred to: the doc+src one or the one in the ports repo, right. ;) Speaking of the ports repo: I remember (correct me if I'm wrong) that a portion of the ports repository (or certain ports within it) is required to build the handbook, so there is already a more or less tightly knit connection between the doc and the ports repo. If we want to make things better (which we should), then we might want to take this fact into account. > 5. There's already more than just source in the svn, namely portmaster > and stress2. It would be nice if we could move all the "user" stuff from > /projects into /user and have /projects be for non-source stuff like > stress2 and portmaster. > > And while we're at it, we call it 'docproj', so why not stick it under > /projects/doc ? (I'm only partially serious about this ...) > > I'm sure there's more that will only be obvious once we've done the > switch. But the actual doc committers have been very silent on this > subject lately. > Well, I for one (welcome our new SVN overlords) have been watching the discussion that unfolded with a keen interest. It seems that there are as much arguments for/against a combined doc+src repo as well as for keeping them separate (and vice versa). From my point of view, I could live with both. However, I remember one thing from my (otherwise very boring) distributed systems lecture back when I was a student: If you are not sure whether to distribute or not, then it is better to distribute, rather than figuring it out afterwards, because it then becomes more messy to divide things again. Something like that, I don't know if that is of any help here (but this would mean separate repos then). I just want to have the SVN migration get underway sooner than later, given all the time it requires to make the transition, of course. Cutting off CVS (no svn2cvs export required IMO) and get back to work, since the next big thing(tm) would be the switch to DocBook XML, which we agreed at the EuroBSDcon DevSummit doc session should come afterwards. Doceng wanted to work on this issue further, but I guess they are busy with release work. Has anyone else some ideas to contribute? Regards Benedict Reuschling FreeBSD Documentation Committer The FreeBSD Documentation Project FreeBSD German Documentation Project - https://doc.bsdgroup.de -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.8 (Darwin) Comment: GPGTools - http://gpgtools.org Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iEYEARECAAYFAk6zCXoACgkQTSZQLkqBk0jHnACeP01eLdTSzYmhLvWuTQ3kryXG SJQAn3tX+4bh4qoiZYou/9Da7vYlQMCy =+mCE -----END PGP SIGNATURE-----