Issue #17270: clarify that the section header doc convention is optional.

cjerdonek · cjerdonek · commit 6c195cd4ef75 · 2013-02-21T18:23:47.000-08:00
diff --git a/documenting.rst b/documenting.rst
@@ -419,7 +419,7 @@ section title with a punctuation character, at least as long as the text::
 
 Normally, there are no heading levels assigned to certain characters as the
 structure is determined from the succession of headings.  However, for the
-Python documentation, we use this convention:
+Python documentation, here is a suggested convention:
 
 * ``#`` with overline, for parts
 * ``*`` with overline, for chapters
