release.rst revision 12037:d28054ac6ec9 
1To release a new version of pybind11:
2
3- Update the version number and push to pypi
4    - Update ``pybind11/_version.py`` (set release version, remove 'dev').
5    - Update ``PYBIND11_VERSION_MAJOR`` etc. in ``include/pybind11/common.h``.
6    - Ensure that all the information in ``setup.py`` is up-to-date.
7    - Update version in ``docs/conf.py``.
8    - Tag release date in ``docs/changelog.rst``.
9    - ``git add`` and ``git commit``.
10    - if new minor version: ``git checkout -b vX.Y``, ``git push -u origin vX.Y``
11    - ``git tag -a vX.Y.Z -m 'vX.Y.Z release'``.
12    - ``git push``
13    - ``git push --tags``.
14    - ``python setup.py sdist upload``.
15    - ``python setup.py bdist_wheel upload``.
16- Update conda-forge (https://github.com/conda-forge/pybind11-feedstock) via PR
17    - change version number in ``recipe/meta.yml``
18    - update checksum to match the one computed by pypi
19- Get back to work
20    - Update ``_version.py`` (add 'dev' and increment minor).
21    - Update version in ``docs/conf.py``
22    - Update version macros in ``include/pybind11/common.h``
23    - ``git add`` and ``git commit``.
24      ``git push``
25