On Wed, Dec 06, 2006 at 12:19:50PM -0500, J. Bruce Fields wrote: > 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. --b. - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html