Document release process

tox-dev · Aug 17, 2023 · f3bf700 · f3bf700
1 parent 3627f11
commit f3bf700
Showing 1 changed file with 19 additions and 0 deletions.
diff --git a/docs/development.rst b/docs/development.rst
@@ -213,6 +213,25 @@ maintainers.
       `Porkbun <https://porkbun.com/>`_
       -- reach out to him directly for any changes).
 
+Creating a new release
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. note::
+
+    The following process assumes that you call the ``remote`` for the main
+    repository for tox ``upstream``.
+
+    .. code::
+
+        git remote add upstream git@github.com:tox-dev/tox.git
+
+In order to create a new release, a maintainer needs to run the following
+command::
+
+    tox r -e release -- <next version>
+
+You need to replace ``<next version>`` with an actual version number
+according to `Semantic Versioning <https://semver.org/>`_.
 
 .. _current-maintainers: