expand "this is not just mercurial" section
diff --git a/doc/contribute.html b/doc/contribute.html
index 633d1b1..92190ca 100644
@@ -173,24 +173,51 @@
it's time to get it reviewed and submitted.
-<h2>Installing the code review extension</h2>
Changes to Go must be reviewed before they are submitted,
no matter who makes the change.
+(In exceptional cases, such as fixing a build, the review can
+follow shortly after submitting.)
A Mercurial extension helps manage the code review process.
The extension is included in the Go source tree but needs
to be added to your Mercurial configuration.
+<h3>Caveat for Mercurial aficionados</h3>
<i>Using Mercurial with the code review extension is not the same
-as using it normally.</i>
+as using standard Mercurial.</i>
-TODO(rsc): note here about model being different.
-Do not use <code>hg commit</code> if you are using the Mercurial extension.
+The Go repository is maintained as a single line of reviewed changes;
+we prefer to avoid the complexity of Mercurial's arbitrary change graph.
+The code review extension helps here: its <code>hg submit</code> command
+automatically checks for and warns about the local repository
+being out of date compared to the remote one.
+The <code>hg submit</code> command also verifies other
+properties about the Go repository.
+it checks that Go code being checked in is formatted in the standard style,
+as defined by <a href="/cmd/gofmt">gofmt</a>,
+and it checks that the author of the code is properly recorded for
+<a href="#copyright">copyright purposes</a>.
+To help ensure changes are only created by <code>hg submit</code>,
+the code review extension disables the standard <code>hg commit</code>
+Mercurial power users: To allow Go contributors to take advantage of
+Mercurial's functionality for local revision control, it might be interesting
+to explore how the code review extension can be made to work alongside
+the Mercurial Queues extension.
<h3>Configure the extension</h3>
@@ -232,7 +259,7 @@
<p>Edit your <a href="http://codereview.prom.corp.google.com/settings">code review settings</a>.
Grab a nickname.
-Many people refer to set the Context option to
+Many people prefer to set the Context option to
“Whole file” to see more context when reviewing changes.
@@ -241,7 +268,7 @@
For example, <code>rsc</code> is an alias for <code>firstname.lastname@example.org</code>.
+<h3>Make a change</h3>
The entire checked-out tree is writable.
@@ -255,8 +282,6 @@
-<h3>Create a change</h3>
<p>When you are ready to send a change out for review, run</p>