From b5f5a52faf28ab13990ebbc577c1a3c206343850 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 9 Dec 2024 15:15:46 +0200
Subject: [PATCH 1/2] Add instructions on manually rebuilding a branch

---
 README.md    |  4 ++--
 RELEASING.md | 16 ++++++++++++++++
 2 files changed, 18 insertions(+), 2 deletions(-)
 create mode 100644 RELEASING.md

diff --git a/README.md b/README.md
index 767014c..b9881e7 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@ This repository contains scripts for automatically building the Python
 documentation on [docs.python.org](https://docs.python.org).
 
 
-# How to test it?
+## How to test it?
 
 The following command should build all maintained versions and
 translations in `./www`, beware it can take a few hours:
@@ -15,7 +15,7 @@ If you don't need to build all translations of all branches, add
 `--language en --branch main`.
 
 
-# Check current version
+## Check current version
 
 Install `tools_requirements.txt` then run `python check_versions.py
 ../cpython/` (pointing to a real CPython clone) to see which version
diff --git a/RELEASING.md b/RELEASING.md
new file mode 100644
index 0000000..abe72cd
--- /dev/null
+++ b/RELEASING.md
@@ -0,0 +1,16 @@
+# Manually rebuild a branch
+
+Docs for [feature and bugfix branches](https://devguide.python.org/versions/) are
+automatically built from a cron.
+
+Manual rebuilds are needed for new security releases,
+and to add the end-of-life banner for newly end-of-life branches.
+
+To manually rebuild a branch, for example 3.11:
+
+```shell
+ssh docs.nyc1.psf.io
+sudo su --shell=/bin/bash docsbuild
+screen -DUR  # Rejoin screen session if it exists, otherwise create a new one
+/srv/docsbuild/venv/bin/python /srv/docsbuild/scripts/build_docs.py --branch 3.11
+```

From 10064ee59d8c6f2fbad2391055d746f1d5deb991 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 10 Dec 2024 23:10:01 +0200
Subject: [PATCH 2/2] Move to README

---
 README.md    | 17 +++++++++++++++++
 RELEASING.md | 16 ----------------
 2 files changed, 17 insertions(+), 16 deletions(-)
 delete mode 100644 RELEASING.md

diff --git a/README.md b/README.md
index b9881e7..1b76bcd 100644
--- a/README.md
+++ b/README.md
@@ -51,3 +51,20 @@ of Sphinx we're using where:
     3.13       8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3    8.1.3  8.1.3  8.1.3    8.1.3
     3.14       8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3  8.1.3    8.1.3  8.1.3  8.1.3    8.1.3
     =========  =====  =====  =====  =====  =====  =====  =====  =====  =======  =====  =====  =======  =======
+
+## Manually rebuild a branch
+
+Docs for [feature and bugfix branches](https://devguide.python.org/versions/) are
+automatically built from a cron.
+
+Manual rebuilds are needed for new security releases,
+and to add the end-of-life banner for newly end-of-life branches.
+
+To manually rebuild a branch, for example 3.11:
+
+```shell
+ssh docs.nyc1.psf.io
+sudo su --shell=/bin/bash docsbuild
+screen -DUR  # Rejoin screen session if it exists, otherwise create a new one
+/srv/docsbuild/venv/bin/python /srv/docsbuild/scripts/build_docs.py --branch 3.11
+```
diff --git a/RELEASING.md b/RELEASING.md
deleted file mode 100644
index abe72cd..0000000
--- a/RELEASING.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# Manually rebuild a branch
-
-Docs for [feature and bugfix branches](https://devguide.python.org/versions/) are
-automatically built from a cron.
-
-Manual rebuilds are needed for new security releases,
-and to add the end-of-life banner for newly end-of-life branches.
-
-To manually rebuild a branch, for example 3.11:
-
-```shell
-ssh docs.nyc1.psf.io
-sudo su --shell=/bin/bash docsbuild
-screen -DUR  # Rejoin screen session if it exists, otherwise create a new one
-/srv/docsbuild/venv/bin/python /srv/docsbuild/scripts/build_docs.py --branch 3.11
-```