summaryrefslogtreecommitdiff
path: root/docs/development/release-process.rst
diff options
context:
space:
mode:
authorMatthias Klose <doko@debian.org>2021-11-27 09:14:41 +0100
committerMatthias Klose <doko@debian.org>2021-11-27 09:14:41 +0100
commit3c577b5ace7676dc680c162a39de78d5bb6e9b5e (patch)
tree2f66ae2b61daa6fc4be752f3f295ea4e93221c78 /docs/development/release-process.rst
Import python-packaging_21.3.orig.tar.gz
[dgit import orig python-packaging_21.3.orig.tar.gz]
Diffstat (limited to 'docs/development/release-process.rst')
-rw-r--r--docs/development/release-process.rst25
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/development/release-process.rst b/docs/development/release-process.rst
new file mode 100644
index 0000000..84e5bec
--- /dev/null
+++ b/docs/development/release-process.rst
@@ -0,0 +1,25 @@
+Release Process
+===============
+
+#. Checkout the current ``main`` branch.
+#. Install the latest ``nox``::
+
+ $ pip install nox
+
+#. Run the release automation with the required version number (YY.N)::
+
+ $ nox -s release -- YY.N
+
+ You will need the password for your GPG key as well as an API token for PyPI.
+
+#. Add a `release on GitHub <https://github.com/pypa/packaging/releases>`__.
+
+#. Notify the other project owners of the release.
+
+.. note::
+
+ Access needed for making the release are:
+
+ - PyPI maintainer (or owner) access to ``packaging``
+ - push directly to the ``main`` branch on the source repository
+ - push tags directly to the source repository