About http://mercurial.selenic.com/

Matt Mackall mpm at selenic.com
Thu Apr 19 16:35:20 UTC 2012


On Thu, 2012-04-19 at 10:22 -0500, David Champion wrote:
> * On 18 Apr 2012, Matt Mackall wrote: 
> > 
> > Well, from interacting with thousands of n00bs, I'm beginning to suspect
> > the quickstart does more harm than good. Having people commit and merge
> > without any mental model of the underlying DAG seems to cause lots of
> > trouble.
> 
> That may be for the kinds of people who have enough gumption and enough
> need of deep understanding to contact the list (or you) -- I can well
> believe it.  But on the other hand these quick start guides will always
> exist, because there are plenty of users with no mental foundation
> for understanding the DAG.  IMO the real advantage of Mercurial's
> having a quick start is to take some ownership of the way that they
> are presented.  The alternative is that a hundred less accurate, less
> useful, and more amateur quick starts spring up in its place.

I agree, we need a quick introduction. But it needs to a) have PICTURES
OF GRAPHS and b) be more than a couple column inches. Which means it
probably doesn't belong on the front page.

It wants to be a hybrid of these two pages:

http://mercurial.selenic.com/wiki/UnderstandingMercurial
http://mercurial.selenic.com/wiki/Tutorial

-- 
Mathematics is the supreme nostalgia of our time.





More information about the Mercurial mailing list