addressed Hugo's feedback

Author: nedbat

Doc/library/builtin-index.rst

@@ -1,24 +1,24 @@
 .. _builtin-index:
 
-##################################
-  Built-in Functions and Classes
-##################################
+#######################
+  Built-ins reference
+#######################
 
 Python comes with a number of built-in functions and classes.
 
-The built-in classes include data types that would normally be considered part of the "core" of a
-language, such as numbers and lists.  For these types, the Python language core
-defines the form of literals and places some constraints on their semantics, but
-does not fully define the semantics.
+The built-in classes include data types that would normally be considered part
+of the "core" of a language, such as numbers and lists.  For these types, the
+Python language core defines the form of literals and places some constraints
+on their semantics, but does not fully define the semantics.
 
-The built-ins also includes functions and exceptions --- objects that can
+The built-ins also include functions and exceptions --- objects that can
 be used by all Python code without the need of an :keyword:`import` statement.
 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 builtin docs.  If desired,
-   :numbered: can be enabled on a per-module basis.
+   :numbered: can be enabled on a per-page basis.
 .. toctree::
    :maxdepth: 2
 

Doc/library/index.rst

@@ -1,11 +1,11 @@
 .. _library-index:
 
 ###############################
-  The Python Standard Library
+  The Python standard library
 ###############################
 
 While :ref:`reference-index` describes the exact syntax and
-semantics of the Python language,  and :ref:`builtin-index` describes
+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

Doc/library/intro.rst

@@ -14,7 +14,7 @@ source form.  Some modules provide interfaces that are highly specific to
 Python, like printing a stack trace; some provide interfaces that are specific
 to particular operating systems, such as access to specific hardware; others
 provide interfaces that are specific to a particular application domain, like
-the web development. Some modules are available in all versions and ports of
+web development. Some modules are available in all versions and ports of
 Python; others are only available when the underlying system supports or
 requires them; yet others are available only when a particular configuration
 option was chosen at the time when Python was compiled and installed.
@@ -27,9 +27,9 @@ browse the table of contents (in front of the manual), or look for a specific
 function, module or term in the index (in the back).  And finally, if you enjoy
 learning about random subjects, you choose a random page
 and read a section or two.  Regardless of the order in which you
-read the sections of this manual, it helps to start with chapter
-:ref:`built-in-funcs`, as the remainder of the manual assumes familiarity with
-this material.
+read the sections of this manual, it helps to first read
+:ref:`built-in-funcs` in :ref:`builtin-index`, as the remainder of this section
+assumes familiarity with this material.
 
 Let the show begin!