Re: [PATCH] Documentation: enhanced "git for CVS users" doc about shared repositories

From: J. Bruce Fields <bfields@fieldses.org>
Date: Nov 7, 2007, 16:47 UTC
Message-ID: <20071107164748.GA10525@fieldses.org>
In-Reply-To: <277490E5-2B9A-4BA7-9DD7-C1CEE698B348@zib.de>

On Wed, Nov 07, 2007 at 09:07:58AM +0100, Steffen Prohaska wrote:

Show 13 quoted lines

> On Nov 7, 2007, at 1:46 AM, Francesco Pretto wrote:
>
>> Junio C Hamano ha scritto:
>>>
>>> Honestly speaking, I am not too thrilled about making the
>>> cvs-migration document much longer than what it currently is.
>>>
>
> Maybe the description of setting up a shared repository should
> go to the user-manual and cvs-migration should refer to the
> user-manual, instead of the other way round. I don't like the
> idea that the user-manual is referring to a CVS specific guide.
> The user manual should be as self-contained as possible.

I'd be interested in patches that did that. If somebody wants to work on that, they might want to start with

	git://linux-nfs.org/~bfields/git.git docwork-foreign-scms

which has the skeleton of an "interoperating with foreign scms" chapter.

The thing that's kept me from working on this in the past is that it's a bit of a step backwards for someone that *just* wants to get to the cvs-migration stuff, since now it may appear you have to plow through the rest of the manual to get to it.

We could address that with clearer dependency information ("before reading this chapter, read chapters 1 and 3..."), and/or by providing some more links (e.g. repopulate the howto directory with links to some chapters that address popular questions).

--b.