add maintainance notes to CONTRIBUTING.rst

Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>

1 files changed, 39 insertions, 0 deletions

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 7472ffa..7ba3a4b 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -41,3 +41,42 @@ an example of a ``Signed-off-by`` line:
 ::
 
     Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
+
+Maintainance
+============
+
+Release process
+---------------
+
+1. Pull any updates to ``debian/`` from the Debian Perl Group's
+   repository on salsa.debian.org
+
+2. Ensure that the test suite passes under autopkgtest, so we can
+   immediately upload the new release to Debian unstable:
+   ``sbuild --dpkg-source-opts='-Zgzip -z1 --format=1.0 -sn'
+   --run-autopkgtest``
+
+3. ``dzil release``
+
+4. Now proceed to update Debian unstable:
+
+   1. ``git deborig``
+   2. If it's not already present, add a new ``debian/changelog``
+      entry with dch(1), or bump the version in an UNRELEASED entry
+   3. sbuild etc.
+   4. ``dgit push-source``
+   5. Push master branch and all tags to both git.spwhitton.name and
+      Debian Perl Team repo on salsa.debian.org.
+
+Changelogs
+----------
+
+Be sure to record changes to the ``debian/`` directory in
+``debian/changelog``, and changes to outside of the ``debian/``
+directory in ``Changes``.
+
+Git usage
+---------
+
+Avoid mixing changes to the ``debian/`` directory and changes to
+outside of the ``debian/`` directory in the same commit.