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] 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
+```