diff --git a/doc/README.md b/doc/README.md
index 3bb8412ad5..666e0966c9 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -27,9 +27,9 @@ ideally referring to a person with the responsibility to complete the note.
 
 Use the following forms in your markdown:
 
-	[`http.Request`](/pkg/net/http#Request)         # symbol documentation
-	[#12345](/issue/12345)                          # GitHub issues
-	[CL 6789](/cl/6789)                             # Gerrit changelists
+	[http.Request]                     # symbol documentation; auto-linked as in Go doc strings
+	[#12345](/issue/12345)             # GitHub issues
+	[CL 6789](/cl/6789)                # Gerrit changelists
 
 ## For the release team