review feedback

Author: nedbat

Doc/library/builtin-index.rst

@@ -17,14 +17,14 @@ Some of these are defined by the core language, but many are not essential for
 the core semantics and are only described here.
 
 .. We don't use :numbered: option for the TOC below as it enforces
-   numbered sections for the entire stdlib docs.  If desired,
+   numbered sections for the entire builtin docs.  If desired,
    :numbered: can be enabled on a per-module basis.
 .. toctree::
    :maxdepth: 2
 
-   functions.rst
-   constants.rst
    stdtypes.rst
+   constants.rst
+   functions.rst
    exceptions.rst
    threadsafety.rst
    time-complexity.rst

Doc/library/index.rst

@@ -5,7 +5,8 @@
 ###############################
 
 While :ref:`reference-index` describes the exact syntax and
-semantics of the Python language, this library reference manual
+semantics of the Python language,  and :ref:`builtin-index` describes
+the built-ins, this library reference manual
 describes the standard library that is distributed with Python. It also
 describes some of the optional components that are commonly included
 in Python distributions.

Doc/tools/templates/indexcontent.html

@@ -59,7 +59,7 @@ <h1>{{ docstitle|e }}</h1>
       <li class="biglink"><a class="biglink" href="{{ pathto("library/builtin-index") }}">{% trans %}Built-in reference{% endtrans %}</a><br>
          <span class="linkdescr">{% trans %}Built-in functions and classes{% endtrans %}</span></li>
       <li class="biglink"><a class="biglink" href="{{ pathto("library/index") }}">{% trans %}Library reference{% endtrans %}</a><br>
-         <span class="linkdescr">{% trans %}Standard library and builtins{% endtrans %}</span></li>
+         <span class="linkdescr">{% trans %}Standard library modules{% endtrans %}</span></li>
       <li class="biglink"><a class="biglink" href="{{ pathto("reference/index") }}">{% trans %}Language reference{% endtrans %}</a><br>
          <span class="linkdescr">{% trans %}Syntax and language elements{% endtrans %}</span></li>
       <li class="biglink"><a class="biglink" href="{{ pathto("using/index") }}">{% trans %}Python setup and usage{% endtrans %}</a><br>