The PEP Rendering System is dead; long live the PEP Rendering System

Author: AA-Turner

.github/CODEOWNERS

@@ -10,12 +10,6 @@
 Makefile                @AA-Turner
 requirements.txt        @AA-Turner
 
-pep0/                   @AA-Turner
-docutils.conf           @AA-Turner
-genpepindex.py          @AA-Turner
-pep2html.py             @AA-Turner
-pep2rss.py              @AA-Turner
-
 pep_sphinx_extensions/  @AA-Turner
 AUTHOR_OVERRIDES.csv    @AA-Turner
 build.py                @AA-Turner

.github/workflows/build.yml

@@ -1,10 +1,10 @@
-name: Sphinx Build
+name: Render PEPs
 
 on: [push, pull_request, workflow_dispatch]
 
 jobs:
-  deploy-to-pages:
-    name: Build & deploy to GitHub Pages
+  render-peps:
+    name: Render PEPs
     runs-on: ubuntu-latest
 
     steps:
@@ -24,7 +24,7 @@ jobs:
           python -m pip install --upgrade pip
           python -m pip install --upgrade -r requirements.txt
 
-      - name: 🔧 Build PEPs
+      - name: 🔧 Render PEPs
         run: make pages -j$(nproc)
 
         # remove the .doctrees folder when building for deployment as it takes two thirds of disk space

.github/workflows/deploy-gh-pages.yml renamed to .github/workflows/render.yml

@@ -2,7 +2,7 @@ Contributing Guidelines
 =======================
 
 To learn more about the purpose of PEPs and how to go about writing one, please
-start reading at `PEP 1 <https://www.python.org/dev/peps/pep-0001/>`_.
+start reading at `PEP 1 <https://peps.python.org/pep-0001/>`_.
 Also, make sure to check the `README <./README.rst>`_ for information
 on how to render the PEPs in this repository.
 Thanks again for your contributions, and we look forward to reviewing them!
@@ -12,7 +12,7 @@ Before writing a new PEP
 ------------------------
 
 Prior to submitting a pull request here with your draft PEP, see `PEP 1
-<https://www.python.org/dev/peps/pep-0001/#start-with-an-idea-for-python>`_
+<https://peps.python.org/pep-0001/#start-with-an-idea-for-python>`_
 for some important steps to consider, including proposing and discussing it
 first in an appropriate venue, drafting a PEP and gathering feedback, and
 developing at least a prototype reference implementation of your idea.

CONTRIBUTING.rst

@@ -1,81 +1,33 @@
-# Builds PEP files to HTML using docutils or sphinx
-# Also contains testing targets
-
-PEP2HTML=pep2html.py
+# Builds PEP files to HTML using sphinx
 
 PYTHON=python3
-
 VENV_DIR=venv
+RENDER_COMMAND=$(PYTHON) build.py -j $(SPHINX_JOBS)
+JOBS=8
 
-.SUFFIXES: .txt .html .rst
-
-.txt.html:
-	@$(PYTHON) $(PEP2HTML) $<
+render:
+	$(RENDER_COMMAND)
 
-.rst.html:
-	@$(PYTHON) $(PEP2HTML) $<
+pages: rss
+	$(RENDER_COMMAND) --build-dirs
 
-TARGETS= $(patsubst %.rst,%.html,$(wildcard pep-????.rst)) $(patsubst %.txt,%.html,$(wildcard pep-????.txt)) pep-0000.html
-
-all: pep-0000.rst $(TARGETS)
-
-$(TARGETS): pep2html.py
+fail-warning:
+	$(RENDER_COMMAND) --fail-on-warning
 
-pep-0000.rst: $(wildcard pep-????.txt) $(wildcard pep-????.rst) $(wildcard pep0/*.py) genpepindex.py
-	$(PYTHON) genpepindex.py .
+check-links:
+	$(RENDER_COMMAND) --check-links
 
 rss:
-	$(PYTHON) pep2rss.py .
-
-install:
-	echo "Installing is not necessary anymore. It will be done in post-commit."
-
-clean:
-	-rm pep-0000.rst
-	-rm *.html
-	-rm -rf build
-
-update:
-	git pull https://github.com/python/peps.git
+	$(PYTHON) generate_rss.py
 
 venv:
 	$(PYTHON) -m venv $(VENV_DIR)
 	./$(VENV_DIR)/bin/python -m pip install -r requirements.txt
 
-package: all rss
-	mkdir -p build/peps
-	cp pep-*.txt build/peps/
-	cp pep-*.rst build/peps/
-	cp *.html build/peps/
-	cp *.png build/peps/
-	cp *.rss build/peps/
-	tar -C build -czf build/peps.tar.gz peps
-
 lint:
 	pre-commit --version > /dev/null || $(PYTHON) -m pip install pre-commit
 	pre-commit run --all-files
 
 spellcheck:
 	pre-commit --version > /dev/null || $(PYTHON) -m pip install pre-commit
 	pre-commit run --all-files --hook-stage manual codespell
-
-# New Sphinx targets:
-
-SPHINX_JOBS=8
-SPHINX_BUILD=$(PYTHON) build.py -j $(SPHINX_JOBS)
-
-# TODO replace `rss:` with this when merged & tested
-pep_rss:
-	$(PYTHON) generate_rss.py
-
-pages: pep_rss
-	$(SPHINX_BUILD) --build-dirs
-
-sphinx:
-	$(SPHINX_BUILD)
-
-fail-warning:
-	$(SPHINX_BUILD) --fail-on-warning
-
-check-links:
-	$(SPHINX_BUILD) --check-links