diff options
Diffstat (limited to 'CONTRIBUTING.rst')
-rw-r--r-- | CONTRIBUTING.rst | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 2671c63..fdc1168 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst | |||
@@ -18,3 +18,20 @@ follow the conventions of the existing API. | |||
18 | 18 | ||
19 | The build system runs ``tox -e tests,release`` on all supported Python | 19 | The build system runs ``tox -e tests,release`` on all supported Python |
20 | versions. You can, and should, run this on your pull request before submitting. | 20 | versions. You can, and should, run this on your pull request before submitting. |
21 | |||
22 | Building a Release | ||
23 | ================== | ||
24 | Official releases are built and uploaded to PyPi using the GitHub |release workflow|_. | ||
25 | To prepare a release, first, bump the ``__version__`` string in | ||
26 | |pandora/__init__.py|_ and push a new release branch with the name | ||
27 | ``release-${version}`` where ``${version}`` is the version number from | ||
28 | |pandora/__init__.py|_. The GitHub workflow will do the rest. | ||
29 | |||
30 | The workflow does the same thing that is documented above with the addition of | ||
31 | an upload to PyPi. | ||
32 | |||
33 | .. |pandora/__init__.py| replace:: ``pandora/__init__.py`` | ||
34 | .. _pandora/__init__.py: https://github.com/mcrute/pydora/tree/master/pandora/__init__.py | ||
35 | |||
36 | .. |release workflow| replace:: ``release`` workflow | ||
37 | .. _release workflow: https://github.com/mcrute/pydora/blob/master/.github/workflows/release.yml | ||