From patchwork Sun Oct 6 22:14:14 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Johannes_L=C3=B6thberg?= X-Patchwork-Id: 1255 Return-Path: Delivered-To: patchwork@archlinux.org Received: from apollo.archlinux.org (localhost [127.0.0.1]) by apollo.archlinux.org (Postfix) with ESMTP id 213471442AA3A for ; Sun, 6 Oct 2019 22:14:38 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on apollo X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIM_SIGNED=0.1, DKIM_VALID=-0.1,DKIM_VALID_AU=-0.1,MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_MED=-2.3,SPF_HELO_NONE=0.001,T_DMARC_POLICY_NONE=0.01 autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-BL-Results: [127.0.9.2] Received: from orion.archlinux.org (orion.archlinux.org [IPv6:2a01:4f8:160:6087::1]) by apollo.archlinux.org (Postfix) with ESMTPS for ; Sun, 6 Oct 2019 22:14:38 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id 197ED15AC82052; Sun, 6 Oct 2019 22:14:31 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [IPv6:2a01:4f8:160:3033::2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits)) (No client certificate requested) by orion.archlinux.org (Postfix) with ESMTPS; Sun, 6 Oct 2019 22:14:31 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 105182CACC; Sun, 6 Oct 2019 22:14:31 +0000 (UTC) Authentication-Results: luna.archlinux.org; dkim=pass (1024-bit key) header.d=kyriasis.com header.i=@kyriasis.com header.b=jiJd88lj Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id ADD5D2CACA for ; Sun, 6 Oct 2019 22:14:26 +0000 (UTC) Received: from theos.kyriasis.com (theos.kyriasis.com [IPv6:2a01:7e00:e000:136::1]) by luna.archlinux.org (Postfix) with ESMTPS for ; Sun, 6 Oct 2019 22:14:26 +0000 (UTC) Received: from theos.kyriasis.com (localhost [127.0.0.1]) by theos.kyriasis.com (OpenSMTPD) with ESMTP id 3a858e93 for ; Sun, 6 Oct 2019 22:14:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=kyriasis.com; h=from:to:cc :subject:date:message-id:mime-version:content-type :content-transfer-encoding; s=theos; bh=QOsq3m4RVwxmVjUSd3twfV7A iPo=; b=jiJd88lja+mTJWBswFF2xClNkfSJnF2uXVPVCWB8tpR/i3RfW72DfVwX AFMJesBrt4fiAH6aj2KLD5Ubg4bq9XJMO+y2VCDigo47vEm6v68QlZnX11kCrdMu aTqD6VZCtsrZ01cpZfp2QZjQOd/jq7gz1lGQiUZhHthmYGQWmSk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=kyriasis.com; h=from:to:cc :subject:date:message-id:mime-version:content-type :content-transfer-encoding; q=dns; s=theos; b=X1sxXsiLF2uRKl6PcT u5HyFc+0DwnGw63mqkL3HA5nLmdnI+XzU28DSvq3yRknUB1UKW6BRnteVSAcD2D/ N8WPCJPS0kaPcjSm2blIFEDx2pps6MzkPf2yGjua96qhGTFon47SGwKi/MjeZ8eV 1fcR9141CGAd1rU//giWXRwfg= Received: from hydrogen.kyriasis.com (h-52-10.A572.priv.bahnhof.se [158.174.52.10]) by theos.kyriasis.com (OpenSMTPD) with ESMTPSA id 82c84b9e (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO); Sun, 6 Oct 2019 22:14:19 +0000 (UTC) From: =?utf-8?q?Johannes_L=C3=B6thberg?= To: pacman-contrib@lists.archlinux.org Subject: [PATCH] Add document describing the release procedures Date: Mon, 7 Oct 2019 00:14:14 +0200 Message-Id: <20191006221414.335031-1-johannes@kyriasis.com> X-Mailer: git-send-email 2.23.0 MIME-Version: 1.0 X-BeenThere: pacman-contrib@lists.archlinux.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion list for pacman-contrib development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: =?utf-8?q?Johannes_L=C3=B6thberg?= Errors-To: pacman-contrib-bounces@lists.archlinux.org Sender: "pacman-contrib" Signed-off-by: Johannes Löthberg --- doc/Makefile.am | 1 + doc/release-procedure.txt | 39 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 doc/release-procedure.txt diff --git a/doc/Makefile.am b/doc/Makefile.am index d5e33ab..57f7b55 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -21,6 +21,7 @@ HTML_MANPAGES = \ HTML_OTHER = \ submitting-patches.html + release-procedure.html HTML_DOCS = \ $(HTML_MANPAGES) \ diff --git a/doc/release-procedure.txt b/doc/release-procedure.txt new file mode 100644 index 0000000..cf205da --- /dev/null +++ b/doc/release-procedure.txt @@ -0,0 +1,39 @@ +Release Procedure +================= + +Preparations +------------ + +-- +Before tagging the release, ensure that: + +* `CHANGES.md` has been updated with all changes that will go into the new release. + +-- + +Procedure +--------- + +-- +Assuming `$VERSION` is the version number in `X.Y.Z` format, and `$REMOTE` is the Git remote for the `pacman-contrib` repository on `git.archlinux.org`: + +* Update the version in `configure.ac`. +* Rename the `Unreleased` section in `CHANGES.md` to `[$VERSION] - YYYY-MM-DD`, and add the git log URL for the new tag to the bottom of the file. +* `git commit -m "Release v$VERSION"` +* `git tag -s v$VERSION -m v$VERSION` +* {blank} ++ +---- +git notes --ref=refs/notes/signatures/tar add -C "$( + git archive --format tar --prefix "pacman-contrib-$VERSION/" v$VERSION | + gpg --output - --armor --detach-sign | + git hash-object -w --stdin +)" v$VERSION +---- +* `git push $REMOTE master $VERSION refs/notes/signatures/tar` + +-- + +///// +vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us: +/////