improved intro about evolve
authorPierre-Yves David <pierre-yves.david@logilab.fr>
Mon, 26 Mar 2012 18:22:09 +0200
changeset 164 c81d286c4a5b
parent 163 92b073d13f2d
child 165 ef6113f3d38e
improved intro about evolve
docs/index.rst
--- a/docs/index.rst	Wed Mar 21 19:09:24 2012 +0100
+++ b/docs/index.rst	Mon Mar 26 18:22:09 2012 +0200
@@ -6,7 +6,7 @@
 Here are various Materials on planned improvement to mercurial regarding
 rewriting mutable history.
 
-The effort is splitted in two part:
+The effort  split in two part:
 
  * The **obsolete marker** concept aiming to provide and alternative to strip to
    get ride of changesets.
@@ -23,13 +23,34 @@
 Evolve: A robust alternative to MQ
 ====================================
 
+Evolve is an experimental history rewriting extensions that use the obsolete
+marker. It is inspired from MQ and pbranch but have multiple advantage over
+them.
 
-* Using the obsolete marker concept, (see next section for advantage of the
-  obsolete marker)
+* sticks to "Work where you are" philosophy (I'll need better wording
+  for that)
+
+* Handle any kind history. Even history with branch and merge.
+
+* Use robust mercurial's merge mechanism 
+
+  simple conflict are handled by real merge tools using appropriate ancestor.
+  Conflict are much rarer and much more user friendly.
 
-* provide a more robust alternative for mq covering any usage but guard.
+* All mutable history available at the same time
+
+  You are do not need to unapply and apply patche to access various part of you
+  history.
 
-..warning:: The evolve extention and the obsolete marker are at an experimental
+* Use plain changeset only. Evole create and exchange real changeset only. 
+  Mutable history can be used in all usual operation 'pull, push, log, diff …)
+
+* Allow sharing and collaborating mutable history without fear of duplicate.
+  (thanks to obsolete marker).
+
+* Cover all mq usage but guard.
+
+.. warning:: The evolve extention and the obsolete marker are at an experimental
             stage. While using obsolet you'll likely be exposed to complexe
             implication of the **obsolete marker** concept. I do not recommend
             non power user to test this at this stage.
@@ -42,7 +63,6 @@
     $ mutable-history/enable.sh > ~/.hgrc
 
 
-
 .. toctree::
    :maxdepth: 1