From cec5658b4946be49eaa5788c1da322efecd480f8 Mon Sep 17 00:00:00 2001 From: Sean Whitton Date: Wed, 5 Feb 2020 17:22:49 -0700 Subject: add maintainance notes to CONTRIBUTING.rst Signed-off-by: Sean Whitton --- CONTRIBUTING.rst | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) 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 + +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. -- cgit v1.2.3