DOC: add Release Process page

Signed-off-by: Filipe Laíns <[email protected]>

Author: FFY00

docs/contributing/release-process.rst

@@ -0,0 +1,74 @@
+.. SPDX-FileCopyrightText: 2023 The meson-python developers
+..
+.. SPDX-License-Identifier: MIT
+
+
+.. _contributing-release-process:
+
+***************
+Release Process
+***************
+
+All releases are PGP signed with one of the keys listed in the
+`installation page`_. Before releasing please make sure your PGP key is listed
+there, and preferably signed by one of the other key holders.
+
+If your key is not signed by one of the other key holders, please make sure the
+PR that added your key to the :ref:`security` page was approved by at least one
+other maintainer.
+
+After that is done, you may release the project by following these steps:
+
+#. Release to the Git_ repository
+    #. Create the release commit
+        #. Bump the versions in ``meson.build`` and ``mesonpy/__init__.py``
+        #. Create ``CHANGELOG.rst`` section for the new release and fill it
+
+        .. admonition:: Release commit format
+           :class: important
+
+           The commit message should follow the ``release X.Y.Z`` format.
+    #. Create a signed tag for the release
+        .. code-block:: console
+
+           $ git tag -s X.Y.Z
+
+        .. admonition:: Release commit format
+           :class: important
+
+           The tag title should follow the ``meson-python X.Y.Z`` format, and the
+           tag body should be a plain text version of the change-log for the current
+           release.
+
+        .. admonition:: Converting the change-log text to plain text
+             :class: hint
+
+             To easily get a plain text version of the change-log, you can push the
+             release commit and then copy the text from rendered version of the
+             change-log in Github.
+
+    #. Push the commit and tag to the repository
+        .. code-block:: console
+
+           $ git push
+           $ git push --tags
+
+#. Release to PyPI_
+    #. Build the Python artifacts
+        .. code-block:: console
+
+           $ python -m build
+
+    #. Sign and push the artifacts to PyPI
+        .. code-block:: console
+
+           $ twine upload -s dist/*
+
+
+If you have any questions, please look at previous releases and/or ping the
+other maintainers.
+
+
+.. _installation page: installation
+.. _Git: https://git-scm.com/
+.. _PyPI: https://pypi.org/

docs/index.rst

@@ -147,6 +147,7 @@ Contributors
    contributing/commit-format
    contributing/test-suite
    contributing/documentation
+   contributing/release-process
 
 
 .. toctree::