New user guide for evolve

Pierre-Yves David pierre-yves.david at ens-lyon.org
Mon May 5 21:53:59 UTC 2014



On 04/26/2014 04:28 PM, Greg Ward wrote:
> Hi all --
>
> I've been working on improving the documentation for evolve. At least
> the text of the new user guide is ready for peer review. (I'm still
> working on drawing the figures.)

Ok, I finally found time to read it all, Its overall very good and needs 
to get in asap. But I've a lots of small feedback about it. We should 
probably start getting it in on chunk at a time, (using mercurial-devel 
to prevent spamming this user focused list.).

I would say the new version on the index is the first thing to focus on.

Unsorted list of feedback on the whole stuff:

- please put a space after -m: `hg commit -m"babar"` → `hg commit -m "babar`
- there is multiple -m flag that seems useless (while calling amend and 
uncommit)
- Maths are cool but we should probably not includes them in the basic 
material for new comers. A "Evolve for Mathematicians" would be cool
- I feel like you are putting some complexity a bit too much forward in 
some part of the user guide. we can discuss it when we come to reviewing 
this specific part.

Looking forward for the first patch on Mercurial-devel!

Thanks again for working on this.

-- 
Pierre-Yves



More information about the Evolve-testers mailing list