@@ -41,7 +41,7 @@ If you don't have nox, you should either use ``pipx run nox`` instead, or use
41
41
interface (very easy: start by clicking the link above).
42
42
- ``git add `` and ``git commit ``, ``git push ``. **Ensure CI passes **. (If it
43
43
fails due to a known flake issue, either ignore or restart CI.)
44
- - Add a release branch if this is a new minor version, or update the existing release branch if it is a patch version
44
+ - Add a release branch if this is a new MINOR version, or update the existing release branch if it is a patch version
45
45
- New branch: ``git checkout -b vX.Y ``, ``git push -u origin vX.Y ``
46
46
- Update branch: ``git checkout vX.Y ``, ``git merge <release branch> ``, ``git push ``
47
47
- Update tags (optional; if you skip this, the GitHub release makes a
@@ -50,7 +50,9 @@ If you don't have nox, you should either use ``pipx run nox`` instead, or use
50
50
- ``git push --tags ``.
51
51
- Update stable
52
52
- ``git checkout stable ``
53
- - ``git merge master ``
53
+ - ``git merge -X theirs vX.Y.Z ``
54
+ - ``git diff vX.Y.Z ``
55
+ - Carefully review and reconcile any diffs. There should be none.
54
56
- ``git push ``
55
57
- Make a GitHub release (this shows up in the UI, sends new release
56
58
notifications to users watching releases, and also uploads PyPI packages).
@@ -69,9 +71,10 @@ If you don't have nox, you should either use ``pipx run nox`` instead, or use
69
71
- Make sure you are on master, not somewhere else: ``git checkout master ``
70
72
- Update version macros in ``include/pybind11/detail/common.h `` (set PATCH to
71
73
``0.dev1 `` and increment MINOR).
72
- - Update ``_version.py `` to match
74
+ - Update ``pybind11/ _version.py `` to match
73
75
- Run ``nox -s tests_packaging `` to ensure this was done correctly.
74
- - Add a spot for in-development updates in ``docs/changelog.rst ``.
76
+ - If the release was a new MINOR version, add a new `IN DEVELOPMENT `
77
+ section in ``docs/changelog.rst ``.
75
78
- ``git add ``, ``git commit ``, ``git push ``
76
79
77
80
If a version branch is updated, remember to set PATCH to ``1.dev1 ``.
0 commit comments