Meta: Move documentation to to peps/ folder (#4538)

AA-Turner · web-flow · commit 03c7456917d9 · 2025-08-08T22:42:36.000+01:00
diff --git a/README.rst b/README.rst
@@ -49,7 +49,7 @@ You can find it in the merge box at the bottom of the PR page:
 Render PEPs locally
 -------------------
 
-See the `build documentation <./docs/build.rst>`__ for full
+See the `build documentation <./peps/docs/build.rst>`__ for full
 instructions on how to render PEPs locally.
 In summary, run the following in a fresh, activated virtual environment:
 
diff --git a/peps/contents.rst b/peps/contents.rst
@@ -15,6 +15,7 @@ This is an internal Sphinx page; please go to the :doc:`PEP Index <pep-0000>`.
    :caption: PEP Table of Contents (needed for Sphinx):
 
    api/*
+   docs/*
    topic/*
    numerical
    pep-*
diff --git a/peps/docs/build.rst b/peps/docs/build.rst
diff --git a/peps/docs/index.rst b/peps/docs/index.rst
@@ -0,0 +1,14 @@
+..
+   We can't use :pep:`N` references in this document, as they use links relative
+   to the current file, which doesn't work in a subdirectory like this one.
+
+PEPs Internal Documentation
+===========================
+
+This is documentation for the internals of the PEPs website and PEP rendering
+system. To read the PEPs, see the :doc:`PEP Index <../pep-0000>`.
+
+------------------------------------------------------------------------------
+
+* :doc:`Building PEPs Locally <./build>`
+* :doc:`An Overview of the PEP Rendering System <./rendering_system>`
diff --git a/peps/docs/rendering_system.rst b/peps/docs/rendering_system.rst
@@ -35,7 +35,7 @@ The configuration:
 ----------------
 
 ``build.py`` manages the rendering process.
-Usage is covered in `Building PEPs Locally <./build.rst>`_.
+Usage is covered in :doc:`Building PEPs Locally <./build>`.
 
 
 3. Extension
