diff -r 99e51aff724b -r fa87604b359c README
--- a/README	Wed Oct 16 18:28:52 2013 +0200
+++ b/README	Fri Nov 15 16:01:40 2013 -0500
@@ -2,47 +2,45 @@
 Mutable History For Mercurial
 =============================
 
-
-Extends Mercurial feature related to Changeset Evolution
-
-This extension provides several commands to mutate history and deal with
-issues it may raise.
+This package supplies the ``evolve`` extension for Mercurial, which
+provides several commands to mutate history and deal with the
+resulting issues.
 
 It also:
 
-    - enables the "Changeset Obsolescence" feature of mercurial,
-    - issues several warning messages when troubles appear in your repository.
+    - enables the "changeset obsolescence" feature of Mercurial
+    - issues several warning messages when trouble appears in your repository
 
-**These extensions are experimental and are not meant for production.**
-
-You can quicky enable it by adding the line below to the extensions
-section of you hgrc::
+**This extension is experimental and not yet meant for production.**
 
-    evolve=PATH/TO/evolve.py
-
-But it's recommended to look at the doc in the first place.
+You can enable it by adding the line below to the ``extensions``
+section of your hgrc::
 
-See doc/ directory for details.
+    evolve = PATH/TO/mutable-history/hgext/evolve.py
 
-Online version of the doc is available:
+We recommend reading the documentation first. An online version is
+available here:
 
     http://hg-lab.logilab.org/doc/mutable-history/html/
 
+Or see the ``doc/`` directory for a local copy.
+
 Contribute
-==================
+==========
 
-The simplest way to contribute is to issue a pull request on bitbucket.
+The simplest way to contribute is to issue a pull request on Bitbucket
+(https://bitbucket.org/marmoute/mutable-history).
 
-However, some cutting edge change may be found in a mutable repository hosted
+However, some cutting-edge changes may be found in a mutable repository hosted
 by logilab before they are published.
 
     http://hg-lab.logilab.org/wip/mutable-history/
 
-Make sure to check lastest draft changeset before submitting new changeset.
+Be sure to check latest draft changeset before submitting new changesets.
 
 
 Changelog
-==================
+=========
 
 3.2.0 --