File: CONTRIBUTING.md

package info (click to toggle)
python-docs-theme 2026.3-1
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 272 kB
  • sloc: javascript: 156; python: 146; makefile: 26
file content (27 lines) | stat: -rw-r--r-- 1,141 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
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`.