diff --git a/.github/workflows/binaries-linux-arm32v7.yml b/.github/workflows/binaries-linux-arm32v7.yml
index 5ad2e81a8..68890265c 100644
--- a/.github/workflows/binaries-linux-arm32v7.yml
+++ b/.github/workflows/binaries-linux-arm32v7.yml
@@ -1,4 +1,4 @@
-# Runs on any push to ci-linux-arm32v7.
+# Runs on any push to binaries-linux-arm32v7.
 # Produces optimised static arm32v7 linux  binaries,
 # using GHC 8.10.4 and cabal.
 # Currently runs no tests.
diff --git a/.github/workflows/binaries-linux-x64.yml b/.github/workflows/binaries-linux-x64.yml
index 6b76d69d7..74ea87fb4 100644
--- a/.github/workflows/binaries-linux-x64.yml
+++ b/.github/workflows/binaries-linux-x64.yml
@@ -1,4 +1,4 @@
-# Runs on any push to ci-linux-x64.
+# Runs on any push to binaries-linux-x64 or binaries.
 # Produces optimised static x64 linux  binaries,
 # using the GHC version below and (cabal or stack) 
 # and Alpine linux, which provides the statically-linkable musl.
@@ -35,6 +35,8 @@ jobs:
     #   run: |
     #     tools/checkembeddedfiles
 
+    # things to be cached/restored:
+
     - name: Uncache ghcup-installed tools
       id:   ghcup
       uses: actions/cache@v4
@@ -111,6 +113,8 @@ jobs:
         restore-keys: |
              ${{ runner.os }}-hledger-web-stack-work-20240417
 
+    # actions:
+
     - name: Install general tools with system package manager
       run: |
         apk --no-cache add binutils-gold curl gcc g++ git gmp-dev ncurses-dev ncurses-static libffi-dev make xz tar perl zlib-dev zlib-static
diff --git a/.github/workflows/binaries-mac-arm64.yml b/.github/workflows/binaries-mac-arm64.yml
index dc7f83d43..a9ce78b68 100644
--- a/.github/workflows/binaries-mac-arm64.yml
+++ b/.github/workflows/binaries-mac-arm64.yml
@@ -1,4 +1,4 @@
-# Runs on any push to ci-mac.
+# Runs on any push to binaries-mac-arm64 or binaries.
 # Produces optimised mac arm64 binaries and runs unit/doc/functional tests,
 # using the default stack.yaml's GHC version.
 
@@ -112,6 +112,8 @@ jobs:
         restore-keys: |
              ${{ runner.os }}-hledger-web-stack-work-from20220817
 
+    # actions:
+
     - name: Add .ghcup/bin to PATH for following steps
       run: |
         echo "$HOME/.ghcup/bin/" >> $GITHUB_PATH
diff --git a/.github/workflows/binaries-mac-x64.yml b/.github/workflows/binaries-mac-x64.yml
index 0a290e22f..07c6fbfb5 100644
--- a/.github/workflows/binaries-mac-x64.yml
+++ b/.github/workflows/binaries-mac-x64.yml
@@ -1,4 +1,4 @@
-# Runs on any push to ci-mac.
+# Runs on any push to binaries-mac-x64 or binaries.
 # Produces optimised mac x64 binaries and runs unit/doc/functional tests,
 # using the default stack.yaml's GHC version.
 
@@ -112,6 +112,8 @@ jobs:
         restore-keys: |
              ${{ runner.os }}-hledger-web-stack-work-from20220817
 
+    # actions:
+
     - name: Add .ghcup/bin to PATH for following steps
       run: |
         echo "$HOME/.ghcup/bin/" >> $GITHUB_PATH
@@ -154,17 +156,6 @@ jobs:
         export PATH=~/.local/bin:$PATH
         COLUMNS=80 $stack exec -- shelltest --execdir -j16 hledger/test -x /_ -x /addons -x ledger-compat/ledger-baseline -x ledger-compat/ledger-regress -x ledger-compat/ledger-collected # bin
 
-    # # This is tested here rather than in the regular CI because it's slow,
-    # # doesn't fail too often, and the cost of late detection and fixing is low.
-    # - name: Test haddock generation
-    #   env:
-    #     stack: ${{ matrix.plan.stack }}
-    #   run: |
-    #     printf "haddock: "; stack exec -- haddock --version
-    #     time $stack build --fast --haddock --no-haddock-deps --no-haddock-hyperlink-source --haddock-arguments="--no-print-missing-docs"
-    #     # --no-haddock-hyperlink-source is 25% faster
-    #     # --no-print-missing-docs is 600% quieter
-
     # artifacts:
 
     - name: Gather binaries
diff --git a/.github/workflows/binaries-windows-x64.yml b/.github/workflows/binaries-windows-x64.yml
index 8bd74666d..c3a878106 100644
--- a/.github/workflows/binaries-windows-x64.yml
+++ b/.github/workflows/binaries-windows-x64.yml
@@ -1,4 +1,4 @@
-# Runs on any push to ci-windows.
+# Runs on any push to binaries-windows-x64 or binaries.
 # Produces optimised windows binaries,
 # using the default stack.yaml's GHC version.
 # Currently runs no tests.