diff -r b494a25915a9 documenting.rst
--- a/documenting.rst	Tue Apr 14 23:05:25 2015 -0700
+++ b/documenting.rst	Sat Apr 18 06:40:49 2015 -0400
@@ -1125,7 +1125,9 @@
 
    A reference to a Python Enhancement Proposal.  This generates appropriate
    index entries. The text "PEP *number*\ " is generated; in the HTML output,
-   this text is a hyperlink to an online copy of the specified PEP.
+   this text is a hyperlink to an online copy of the specified PEP. Such
+   hyperlinks should not be a substitute for properly documenting the
+   language in the manuals.
 
 .. describe:: rfc