Re: [PATCH] cvs-migration document: make the need for "push" more obvious

From: J. Bruce Fields <bfields@fieldses.org>
Date: Dec 6, 2006, 17:24 UTC
Message-ID: <20061206172450.GE1714@fieldses.org>
In-Reply-To: <20061206171950.GD1714@fieldses.org>

On Wed, Dec 06, 2006 at 12:19:50PM -0500, J. Bruce Fields wrote:

Show 6 quoted lines

> On Wed, Dec 06, 2006 at 04:16:57PM +0100, Johannes Schindelin wrote:
> Definitely, I agree.  So that argues for locating the most import stuff
> as close to start of the document as possible.  But obviously there's
> lot of important stuff and you can't do that with everything, so you
> also have to rely on keeping things organized so people can more easily
> skip to the middle.

Hm, but, come to think of it, I agree with you that the "how to commit and push" really should come earlier, since that's the stuff most people need to know; currently the order is roughly:

	importing a cvs archive
	creating a shared repository
	committing to a shared repository

We should start out with the assumption that a shared repo is already set up and make it:

	committing to a shared repository
	creating a shared repository
	importing a cvs archive

which puts it in stuff-most-people-need-to-know to stuff-less-people-need-to-know order. Maybe the current introduction should even be postponed to later.

And some day we should move that whole final CVS annotate section elsewhere.