python-docs-theme 2026.3__tar.gz → 2026.7__tar.gz

python_docs_theme-2026.7/.babel.cfg

@@ -0,0 +1,3 @@
+[javascript: **.js]
+
+[jinja2: **.html]

python_docs_theme-2026.7/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: monthly
+    assignees:
+      - "ezio-melotti"
+    groups:
+      actions:
+        patterns:
+          - "*"
+    cooldown:
+      default-days: 7

python_docs_theme-2026.7/.github/release.yml

@@ -0,0 +1,5 @@
+changelog:
+  exclude:
+    authors:
+      - dependabot[bot]
+      - pre-commit-ci[bot]

python_docs_theme-2026.7/.github/workflows/lint.yml

@@ -0,0 +1,19 @@
+name: Lint
+
+on: [push, pull_request, workflow_dispatch]
+
+permissions: {}
+
+env:
+  FORCE_COLOR: 1
+  RUFF_OUTPUT_FORMAT: github
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: j178/prek-action@bdca6f102f98e2b4c7029491a53dfd366469e33d # v2.0.4

python_docs_theme-2026.7/.github/workflows/pypi-package.yml

@@ -0,0 +1,52 @@
+name: Build & maybe upload PyPI package
+
+on:
+  push:
+  pull_request:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+permissions: {}
+
+env:
+  FORCE_COLOR: 1
+
+jobs:
+  # Always build & lint package.
+  build-package:
+    name: Build & verify package
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+
+      - uses: hynek/build-and-inspect-python-package@d44ca7d91762de7a7d5436ddae667c6da6d1c3df # v2.18.0
+
+  # Upload to real PyPI on GitHub Releases.
+  release-pypi:
+    name: Publish to PyPI
+    environment: release-pypi
+    # Only run for published releases.
+    if: |
+      github.repository_owner == 'python'
+      && github.event.action == 'published'
+    runs-on: ubuntu-latest
+    needs: build-package
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download packages built by build-and-inspect-python-package
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: Packages
+          path: dist
+
+      - name: Upload package to PyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0

python_docs_theme-2026.7/.github/workflows/tests.yml

@@ -0,0 +1,95 @@
+name: Tests
+
+on: [push, pull_request, workflow_dispatch]
+
+permissions: {}
+
+env:
+  FORCE_COLOR: 1
+
+jobs:
+  build_doc:
+    name: Build CPython docs
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.15", "3.14", "3.13", "3.12"]
+        include:
+          - python-version: "3.15"
+            branch: "main"
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+          cache: pip
+      - name: Clone docsbuild scripts
+        run: |
+          git clone https://github.com/python/docsbuild-scripts/
+      - name: Set up requirements
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r docsbuild-scripts/requirements.txt
+      - name: Build documentation
+        run: >
+          python ./docsbuild-scripts/build_docs.py
+          --quick
+          --build-root ./build_root
+          --www-root ./www
+          --log-directory ./logs
+          --group "$(id -g)"
+          --skip-cache-invalidation
+          --theme "$(pwd)"
+          --languages en
+          --branches ${{ matrix.branch || matrix.python-version }}
+          ${{ matrix.branch == 'main' && '--select-output no-html' || '' }}
+      - name: Show logs
+        if: failure()
+        run: |
+          cat ./logs/docsbuild.log
+      - name: Upload
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: doc-html-${{ matrix.python-version }}
+          path: www/
+
+  translations:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: ["ubuntu-latest", "windows-latest"]
+        # Test minimum supported and latest stable from 3.x series
+        python-version: ["3.12", "3"]
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+          cache: pip
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -r requirements.txt
+      - name: Remove locale file for testing
+        shell: bash
+        run: rm -rf python_docs_theme/locale/pt_BR/
+      - run: python babel_runner.py extract
+      - run: python babel_runner.py init -l pt_BR
+      - run: python babel_runner.py update
+      - run: python babel_runner.py update -l pt_BR
+      - run: python babel_runner.py compile
+      - run: python babel_runner.py compile -l pt_BR
+      - name: Print .pot file
+        shell: bash
+        run: cat python_docs_theme/locale/python-docs-theme.pot
+      - name: Print .po file
+        shell: bash
+        run: cat python_docs_theme/locale/pt_BR/LC_MESSAGES/python-docs-theme.po

python_docs_theme-2026.7/.gitignore

@@ -0,0 +1,101 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/

python_docs_theme-2026.7/.pre-commit-config.yaml

@@ -0,0 +1,56 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+      - id: ruff-check
+        args: [--exit-non-zero-on-fix]
+
+  - repo: https://github.com/psf/black-pre-commit-mirror
+    rev: 26.5.1
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: check-yaml
+      - id: debug-statements
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.37.4
+    hooks:
+      - id: check-dependabot
+      - id: check-github-workflows
+
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.12
+    hooks:
+      - id: actionlint
+
+  - repo: https://github.com/zizmorcore/zizmor-pre-commit
+    rev: v1.26.1
+    hooks:
+      - id: zizmor
+
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.25.1
+    hooks:
+      - id: pyproject-fmt
+
+  - repo: https://github.com/abravalheri/validate-pyproject
+    rev: v0.25
+    hooks:
+      - id: validate-pyproject
+
+  - repo: meta
+    hooks:
+      - id: check-hooks-apply
+      - id: check-useless-excludes
+
+ci:
+  autoupdate_schedule: quarterly

python_docs_theme-2026.7/.readthedocs.yml

@@ -0,0 +1,15 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+# Project page: https://readthedocs.org/projects/python-docs-theme-previews/
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3"
+
+  commands:
+    - git clone --depth=1 https://github.com/python/cpython
+    - make html CPYTHON_PATH=cpython
+    - mv cpython/Doc/build _readthedocs

python_docs_theme-2026.7/CHANGELOG.md

@@ -0,0 +1,273 @@
+# Changelog
+
+## [2026.7](https://github.com/python/python-docs-theme/releases/tag/2026.7)
+
+* Add Vietnamese translation by @StanFromIreland in https://github.com/python/python-docs-theme/pull/309
+* Switch to Hatchling build hooks for i18n packaging and exclude .po from wheels by @StanFromIreland in https://github.com/python/python-docs-theme/pull/312
+
+## [2026.4](https://github.com/python/python-docs-theme/releases/tag/2026.4)
+
+* Add styling for the `soft-deprecated` class by @StanFromIreland
+  in https://github.com/python/python-docs-theme/pull/305
+* Add Tamil translation in https://github.com/python/python-docs-theme/pull/304
+* Fix the vertical alignment of `:Editor:` by @pradyunsg in
+  https://github.com/python/python-docs-theme/pull/303
+
+## [2026.3](https://github.com/python/python-docs-theme/releases/tag/2026.3)
+
+* Add colors for new thread-safety levels by @lysnikolaou in https://github.com/python/python-docs-theme/pull/299
+
+## [2026.2](https://github.com/python/python-docs-theme/releases/tag/2026.2)
+
+* Style codeblock `:caption:` by @StanFromIreland in https://github.com/python/python-docs-theme/pull/288
+* Enable copy button for shell sessions and consoles by @hugovk in https://github.com/python/python-docs-theme/pull/295
+* Add colors for thread safety annotations by @lysnikolaou in https://github.com/python/python-docs-theme/pull/297
+
+## [2025.12](https://github.com/python/python-docs-theme/releases/tag/2025.12)
+
+* Add support for green, red and yellow side borders for code examples by @hugovk in https://github.com/python/python-docs-theme/pull/285
+* Add Portuguese translation by @NyaPuma in https://github.com/python/python-docs-theme/pull/281
+* Add support for Python 3.15 by @hugovk in https://github.com/python/python-docs-theme/pull/282
+* Convert CHANGELOG and CONTRIBUTING from .rst to .md by @hugovk in https://github.com/python/python-docs-theme/pull/277
+* Add zizmor to CI and fix findings by @hugovk in https://github.com/python/python-docs-theme/pull/283
+
+## [2025.10](https://github.com/python/python-docs-theme/releases/tag/2025.10)
+
+* Add Romanian translation by @octaG-M in https://github.com/python/python-docs-theme/pull/272
+* Add Arabic and Russian translations by @StanFromIreland in https://github.com/python/python-docs-theme/pull/274
+* Add French translation by @JulienPalard in https://github.com/python/python-docs-theme/pull/275
+* Update authors in `pyproject.toml` by @StanFromIreland in https://github.com/python/python-docs-theme/pull/271
+* Add link to devguide in README by @StanFromIreland in https://github.com/python/python-docs-theme/pull/266
+
+## [2025.9.2](https://github.com/python/python-docs-theme/releases/tag/2025.9.2)
+
+* Add Korean and Indonesian translations from Transifex in https://github.com/python/python-docs-theme/pull/264
+* Add German translation by @cmaureir in https://github.com/python/python-docs-theme/pull/262
+* Fix compilation of translations and loading of translations on pages with html
+  source in https://github.com/python/python-docs-theme/pull/263
+* Fix search button cutting off long translations in https://github.com/python/python-docs-theme/pull/268
+* Fix `Copy` button copying line numbers by @StanFromIreland in https://github.com/python/python-docs-theme/pull/270
+
+## [2025.9.1](https://github.com/python/python-docs-theme/releases/tag/2025.9.1)
+
+* Add Japanese, Turkish and Spanish translations from Transifex in https://github.com/python/python-docs-theme/pull/259
+
+## [2025.9](https://github.com/python/python-docs-theme/releases/tag/2025.9)
+
+* Enable theme translation and add Polish by @StanFromIreland in https://github.com/python/python-docs-theme/pull/246
+* Add Greek translation by @lysnikolaou and @skpanagiotis in https://github.com/python/python-docs-theme/pull/256 and https://github.com/python/python-docs-theme/pull/257
+* Add Swedish translation by @yeager in https://github.com/python/python-docs-theme/pull/250
+* Add Brazilian Portuguese, Simplified Chinese and Traditional Chinese translations from [Transifex](https://explore.transifex.com/python-doc/python-docs-theme/) in https://github.com/python/python-docs-theme/pull/253
+
+## [2025.5](https://github.com/python/python-docs-theme/releases/tag/2025.5)
+
+* Make the copy button only appear when hovered over or clicked on by @kevteg in https://github.com/python/python-docs-theme/pull/243
+
+## [2025.4.1](https://github.com/python/python-docs-theme/releases/tag/2025.4.1)
+
+* Fix copy button with multiple tracebacks by @tomasr8 in https://github.com/python/python-docs-theme/pull/240
+
+## [2025.4](https://github.com/python/python-docs-theme/releases/tag/2025.4)
+
+* Require Sphinx 7.3 by @AA-Turner in https://github.com/python/python-docs-theme/pull/221
+* Add support for Python 3.14 by @hugovk https://github.com/python/python-docs-theme/pull/236
+* Drop support for Python 3.10 and 3.11 by @hugovk in https://github.com/python/python-docs-theme/pull/234
+* Add a copy button to code samples by @tomasr8 in https://github.com/python/python-docs-theme/pull/231
+* Add missing i18n for copy button titles by @tomasr8 in https://github.com/python/python-docs-theme/pull/225
+* Use consistent line-height for light & dark theme by @tomasr8 in https://github.com/python/python-docs-theme/pull/227
+* Remove self-closing tags by @hugovk in https://github.com/python/python-docs-theme/pull/226
+* Replace deprecated classifier with licence expression (PEP 639) by @hugovk in https://github.com/python/python-docs-theme/pull/237
+
+## [2025.2](https://github.com/python/python-docs-theme/releases/tag/2025.2)
+
+- Note minimum requirements for Sphinx (#216)
+    Contributed by Adam Turner
+- Horizontally centre the sidebar collapse button (#219)
+    Contributed by Tomas Roun
+- Make sidebar width more flexible (#218)
+    Contributed by Tomas Roun
+- Set `__version__` in the runtime package (#222)
+    Contributed by Adam Turner
+
+## [2024.12](https://github.com/python/python-docs-theme/releases/tag/2024.12)
+
+- Hide header and search bar when printing (#204)
+    Contributed by Hugo van Kemenade
+
+## [2024.10](https://github.com/python/python-docs-theme/releases/tag/2024.10)
+
+- Add support for Python 3.13 (#196)
+    Contributed by Hugo van Kemenade
+- Drop support for Python 3.8 (#197)
+    Contributed by Hugo van Kemenade
+- Add script for handling translations (#195)
+    Contributed by Rafael Fontenelle
+- Generate digital attestations for PyPI (PEP 740) (#198)
+    Contributed by Hugo van Kemenade
+
+## [2024.6](https://github.com/python/python-docs-theme/releases/tag/2024.6)
+
+- Add backgrounds and borders to admonitions (#190)
+    Contributed by Hugo van Kemenade
+- Use different colour for 'Return value: Borrowed reference' (#188)
+    Contributed by Hugo van Kemenade
+
+## [2024.4](https://github.com/python/python-docs-theme/releases/tag/2024.4)
+
+- Add colour to version change directives (#185)
+    Contributed by Hugo van Kemenade
+- Only show 'Last updated on ...' when `last_updated` defined (#183)
+    Contributed by Hugo van Kemenade
+- Use system font stack for all code (#186)
+    Contributed by Hugo van Kemenade
+
+## [2024.3](https://github.com/python/python-docs-theme/releases/tag/2024.3)
+
+- Modernise font: use system font stack to improve text readability and webpage performance (#174)
+    Contributed by Hugo van Kemenade
+- Remove incorrect CSS property (#178)
+    Contributed by Kerim Kabirov
+
+## [2024.2](https://github.com/python/python-docs-theme/releases/tag/2024.2)
+
+- Do not underline navigation links (#169)
+   Contributed by Hugo van Kemenade
+- Only apply underline offset to code formatting for underline visibility (#171)
+   Contributed by Hugo van Kemenade
+
+## [2024.1](https://github.com/python/python-docs-theme/releases/tag/2024.1)
+
+- Underline links for readability and a11y (#160, #166)
+   Contributed by Hugo van Kemenade
+- Add `hosted_on` variable for a link in the footer (#165)
+   Contributed by Hugo van Kemenade
+- Consistently reference `theme_root_icon` (#163)
+   Contributed by Marko Budiselic
+- Dark mode: fix contrast of footer highlight (#162)
+   Contributed by Hugo van Kemenade
+
+## [2023.9](https://github.com/python/python-docs-theme/releases/tag/2023.9)
+
+- Focus search box when pressing slash (#153)
+   Contributed by Hugo van Kemenade
+
+## [2023.8](https://github.com/python/python-docs-theme/releases/tag/2023.8)
+
+- Add Python 3.12 and 3.13 classifiers (#147)
+   Contributed by Hugo van Kemenade
+- Dark mode: Also give aside.topic a dark background (#150)
+   Contributed by Hugo van Kemenade
+- Restore the menu on mobile devices (inadvertently broken in 2023.7) (#146)
+   Contributed by Hugo van Kemenade
+
+## [2023.7](https://github.com/python/python-docs-theme/releases/tag/2023.7)
+
+- Fix compatibility with Sphinx 7.1 (#137)
+   Contributed by Pradyun Gedam
+- Enable the slash keypress to focus the search field (#141)
+   Contributed by Mike Fiedler
+- Sphinx 6.2 fix: add `nav.contents` where `div.topic` is used (#138)
+   Contributed by Hugo van Kemenade
+- Dark mode: fix contrast for C++ specific styling (#133)
+   Contributed by Hugo van Kemenade
+- Don't let long code literals extend beyond the right side of the screen (#139)
+   Contributed by Hugo van Kemenade
+- Test with Python 3.12 (#140)
+   Contributed by Hugo van Kemenade
+
+## [2023.5](https://github.com/python/python-docs-theme/releases/tag/2023.5)
+
+- Add a dark theme. (#44)
+   Contributed by Nils K
+- Fix: Remove searchbox id from form. (fixes #117)
+   Contributed by Nils K
+- Update `python-docs-theme` to work with Sphinx 5 & 6. (#99 & #127)
+   Contributed by Adam Turner
+- Override font for `.sig` for consistency with other code blocks. (#121)
+   Contributed by Chris Warrick
+- Dark mode: add class to invert image brightness. (#128)
+   Contributed by Hugo van Kemenade
+
+
+## [2023.3.1](https://github.com/python/python-docs-theme/releases/tag/2023.3.1)
+
+- Skip cache-busting for old Sphinx #113
+
+
+## [2023.3](https://github.com/python/python-docs-theme/releases/tag/2023.3)
+
+- Fix problem with monospace rendering in Vivaldi #104
+- Fix mobile nav obstructing content #96
+- Reduce footer margin only for desktop #106
+- Append a hash ?digest to CSS files for cache-busting #108
+
+
+## [2022.1](https://github.com/python/python-docs-theme/releases/tag/2022.1)
+
+- Add a configuration for license URL. (#90)
+- Exclude the floating navbar from CHM help. (#84)
+- Make sidebar scrollable and sticky (on modern browsers) (#91)
+
+
+## [2021.11.1](https://github.com/python/python-docs-theme/releases/tag/2021.11.1)
+
+- Fix monospace again, on buggy Google Chrome (#87)
+   Contributed by Tushar Sadhwani
+
+
+## [2021.11](https://github.com/python/python-docs-theme/releases/tag/2021.11)
+
+- Fix monospace on buggy Google Chrome (#85)
+   Contributed by Tushar Sadhwani
+
+
+## [2021.8](https://github.com/python/python-docs-theme/releases/tag/2021.8)
+
+- Add the copyright_url variable in the theme (#67)
+   Contributed by jablonskidev
+- Improve readability (#79)
+   Contributed by Olga Bulat
+- Remove #searchbox on mobile to fix a layout bug (#76)
+   Contributed by Olga Bulat
+- Fix the appearance of version/language selects (#74)
+   Contributed by Olga Bulat
+
+
+## [2021.5](https://github.com/python/python-docs-theme/releases/tag/2021.5)
+
+- Make the theme responsive (#46)
+   Contributed by Olga Bulat.
+- Use Python 3.8 for the Github Actions (#71)
+   Contributed by Stéphane Wirtel.
+- Use default pygments theme (#68)
+   Contributed by Aaron Carlisle.
+- Test Github action to validate the theme against docsbuild scripts. (#69)
+   Contributed by Julien Palard.
+- Add the copy button to pycon3 highlighted code blocks. (#64)
+   Contributed by Julien Palard.
+
+
+## [2020.12](https://github.com/python/python-docs-theme/releases/tag/v2020.12)
+
+- Updated the readme, to remind user to install the package in a virtual environment. (#41)
+   Contributed by Mariatta.
+- Updated the package url, using the GitHub repository instead of docs.python.org (#49)
+   Contributed by Pradyun Gedam.
+- Added license information to the footer of the doc (#36)
+   Contributed by Todd.
+- Fixed typo in the footer (#52)
+   Contributed by Dominic Davis-Foster.
+- Added information on how to use the package (#32)
+   Contributed by Tapasweni Pathak.
+- Fixed code formatting (#53).
+   Contributed by Hugo van Kemenade.
+- Fixed code bgcolor and codetextcolor for Sphinx 3.1.0+ (#57)
+   Contributed by Zhiming Wang.
+
+## 2018.7
+Corresponds to [44a8f30](https://github.com/python/python-docs-theme/commit/44a8f306db9ec86d277a8a687538d5d51e415130)
+
+
+## [2018.2](https://github.com/python/python-docs-theme/releases/tag/2018.2)
+
+Initial release.

python_docs_theme-2026.7/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# How to release
+
+- Update `CHANGELOG.md`
+- Bump version (YYYY.MM) in `python_docs_theme/__init__.py`
+- Commit
+- Push to check tests pass on
+  [GitHub Actions](https://github.com/python/python-docs-theme/actions)
+- Go to https://github.com/python/python-docs-theme/releases
+- Click "Draft a new release"
+- Click "Tag: Select tag"
+- Type the next YYYY.MM version (no leading zero) and
+  select "Create new tag"
+- Click "Create" for "YYYY.MM will be created on publish"
+- Leave the "Release title" blank (it will be autofilled)
+- Click "Generate release notes" and amend as required
+- Click "Publish release"
+- Check the tagged [GitHub Actions build](https://github.com/python/python-docs-theme/actions/workflows/pypi-package.yml)
+  has deployed to [PyPI](https://pypi.org/project/python-docs-theme/#history)
+
+# Makefile usage
+
+This project includes a simple Makefile for syncing changes to the theme with
+the main CPython repository. Run `make help` for details on available rules.
+
+There is one configurable variable, `CPYTHON_PATH`, which should be the path
+to the CPython repository on your machine. By default, it points to
+`../cpython`.