doc: update contribution guidelines to prefix the change description

with the primary affected package.

R=rsc, adg
CC=golang-dev
https://golang.org/cl/3867041

diff --git a/doc/contribute.html b/doc/contribute.html
index 4758a0896b856e98de496490a1bad21999c3e890..f18346bca6240c5c47f03e4bf0a6efbecb8e3491 100644 (file)
--- a/doc/contribute.html
+++ b/doc/contribute.html
@@ -218,9 +218,9 @@ mailing list.
 <p>
 Replace &ldquo;<code>&lt;enter description here&gt;</code>&rdquo;
 with a description of your change.
-The first line of the change description is conventionally
-a one-line summary of the change and is used as the
-subject for code review mail; the rest of the
+The first line of the change description is conventionally a one-line
+summary of the change, prefixed by the primary affected package,
+and is used as the subject for code review mail; the rest of the
 description elaborates.
 </p>
 
@@ -245,7 +245,7 @@ Reviewer: golang-dev@googlegroups.com
 CC: math-nuts@swtch.com
 
 Description:
-       Sin, Cos, Tan: improved precision for very large arguments
+       math: improved Sin, Cos and Tan precision for very large arguments.
 
        See Bimmler and Shaney, ``Extreme sinusoids,'' J. Math 3(14).
        Fixes issue 159.