Apply suggestions from code review

Co-authored-by: Adam Turner <[email protected]>
python · Sep 25, 2024 · 4e378fe · 4e378fe
1 parent 86151ac
commit 4e378fe
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 2 deletions.
diff --git a/pep_sphinx_extensions/pep_zero_generator/writer.py b/pep_sphinx_extensions/pep_zero_generator/writer.py
@@ -133,6 +133,7 @@ def emit_pep_category(self, category: str, peps: list[PEP]) -> None:
         self.emit_newline()
 
     def write_numerical_index(self, peps: list[PEP]) -> str:
+        """Write PEPs by number."""
         self.emit_text(".. _numerical-index:")
         self.emit_newline()
 
@@ -190,7 +191,10 @@ def write_pep0(
         # PEPs by number
         if is_pep0:
             self.emit_title("Numerical Index")
-            self.emit_text("All PEPs :ref:`sorted by number <numerical-index>`.")
+            self.emit_text(
+                "The :doc:`numerical index </numerical>` contains "
+                "a table of all PEPs :ref:`sorted by number <numerical-index>`."
+            )
             self.emit_newline()
 
         # PEPs by category

diff --git a/peps/contents.rst b/peps/contents.rst
@@ -15,6 +15,6 @@ This is an internal Sphinx page; please go to the :doc:`PEP Index <pep-0000>`.
    :caption: PEP Table of Contents (needed for Sphinx):
 
    api/*
+   topic/*
    numerical
    pep-*
-   topic/*