[llvm] docs: Adjust HowToReleaseLLVM to include man page signing (PR #210092)

[Konrad Kleine via llvm-commits]

https://github.com/kwk updated https://github.com/llvm/llvm-project/pull/210092

>From 7b3ffabc13fadb719d88b6332901b83c15cd13da Mon Sep 17 00:00:00 2001
From: Konrad Kleine <kkleine at redhat.com>
Date: Thu, 16 Jul 2026 18:14:41 +0200
Subject: [PATCH 1/2] docs: Adjust HowToReleaseLLVM to include man page signing

---
 llvm/docs/HowToReleaseLLVM.rst | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/llvm/docs/HowToReleaseLLVM.rst b/llvm/docs/HowToReleaseLLVM.rst
index 2524e1715ca18..a8ca161098d40 100644
--- a/llvm/docs/HowToReleaseLLVM.rst
+++ b/llvm/docs/HowToReleaseLLVM.rst
@@ -162,14 +162,20 @@ The pre-packaged source tarballs will be automatically generated via the
 `Release Sources
 <https://github.com/llvm/llvm-project/actions/workflows/release-sources.yml>`_
 workflow on GitHub.  This workflow will create an artifact containing all the
-release tarballs and the artifact attestation.  The Release Manager should
-download the artifact, verify the tarballs, sign them, and then upload them to
-the release page.
+release tarballs and the artifact attestation.  Additionally the `Release
+Documentation
+<https://github.com/llvm/llvm-project/actions/workflows/release-documentation.yml>`_
+workflow will run and create an artifact containing the man pages and the
+artifact attestation. The Release Manager should download the artifacts from
+both workflows, verify the tarballs, sign them, and then upload them to the
+release page.
 
 ::
 
-  $ unzip artifact.zip
   $ gh auth login
+  $ unzip source-artifact.zip
+  $ for f in *.xz; do gh attestation verify --owner llvm $f && gpg -b $f; done
+  $ unzip documentation-artifact.zip
   $ for f in *.xz; do gh attestation verify --owner llvm $f && gpg -b $f; done
 
 Tarballs, release binaries,  or any other release artifacts must be uploaded to

>From 79e37c967a13d0267e3fb569ca804b69fae4ef7d Mon Sep 17 00:00:00 2001
From: Konrad Kleine <kkleine at redhat.com>
Date: Tue, 21 Jul 2026 10:48:33 +0200
Subject: [PATCH 2/2] Don't duplicate instructions

See https://github.com/llvm/llvm-project/pull/210092#pullrequestreview-4720335537
---
 llvm/docs/HowToReleaseLLVM.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/llvm/docs/HowToReleaseLLVM.rst b/llvm/docs/HowToReleaseLLVM.rst
index a8ca161098d40..95492f5c1ec6b 100644
--- a/llvm/docs/HowToReleaseLLVM.rst
+++ b/llvm/docs/HowToReleaseLLVM.rst
@@ -172,10 +172,8 @@ release page.
 
 ::
 
+  $ unzip artifact.zip
   $ gh auth login
-  $ unzip source-artifact.zip
-  $ for f in *.xz; do gh attestation verify --owner llvm $f && gpg -b $f; done
-  $ unzip documentation-artifact.zip
   $ for f in *.xz; do gh attestation verify --owner llvm $f && gpg -b $f; done
 
 Tarballs, release binaries,  or any other release artifacts must be uploaded to