From 42961d6bd4c2e379539e8dd117407fd584357384 Mon Sep 17 00:00:00 2001
From: Ned Batchelder <ned@nedbatchelder.com>
Date: Fri, 15 Nov 2024 08:39:58 -0500
Subject: [PATCH] build: tweaks to release process

---
 howto.txt | 30 ++++++++++++++----------------
 1 file changed, 14 insertions(+), 16 deletions(-)

diff --git a/howto.txt b/howto.txt
index 1c7b114fc..add59d6d8 100644
--- a/howto.txt
+++ b/howto.txt
@@ -36,38 +36,36 @@
         $ make sample_html
         - check in the new sample html
             $ make relcommit2
+- Build and publish docs:
+    - IF PRE-RELEASE:
+        $ make publishbeta
+    - ELSE:
+        $ make publish
+    - commit and publish nedbatchelder.com
 - Done with changes to source files
-    - g puo; gshipit
+    $ g puo; gshipit
         - check them in on the release prep branch
         - wait for ci to finish
         - merge to master
         - git push
 - Start the kits:
-    - opvars github
+    $ opvars github
     - Trigger the kit GitHub Action
         $ make build_kits
-- Build and publish docs:
-    - IF PRE-RELEASE:
-        $ make publishbeta
-    - ELSE:
-        $ make publish
-    - commit and publish nedbatchelder.com
 - Kits:
     - Wait for kits to finish:
         - https://github.com/nedbat/coveragepy/actions/workflows/kit.yml
     - test the pypi upload:
         $ make test_upload
-        - you'll need to approve the action
+        - approve the action
             - https://github.com/nedbat/coveragepy/actions/workflows/publish.yml
     - upload kits:
         $ make pypi_upload
-        - you'll need to approve the action
+        - approve the action
             - https://github.com/nedbat/coveragepy/actions/workflows/publish.yml
-- Tag the tree
-    $ make tag
-- Update GitHub releases and comment on issues:
-    $ make clean github_releases comment_on_fixes
-- deopvars
+- Tag the tree, update GitHub releases and comment on issues:
+    $ make clean tag github_releases comment_on_fixes
+$ deopvars
 - Bump version:
     $ make bump_version
 - Update readthedocs
@@ -79,7 +77,7 @@
         - @ https://readthedocs.org/dashboard/coverage/advanced/
             - change the "default version" to the new version
 - Once CI passes, merge the bump-version branch to master and push it
-    - gshipit
+    $ gshipit
 
 - things to automate:
     - readthedocs api to do the readthedocs changes