diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml
index 3cb3252fb..6943c40c8 100644
--- a/.github/workflows/publish.yaml
+++ b/.github/workflows/publish.yaml
@@ -35,6 +35,7 @@ jobs:
           sed -i \
              -e '/bazel_dep(name = "rules_haskell"/s/version = "[^"]*"/version = "${{ steps.latest.outputs.version }}"/' \
              start
+          # update http_archive attrs between `cat > WORKSPACE` and `EOF`
           sed -i \
              -e '/cat > WORKSPACE/,/^EOF/{' \
              -e '  s%sha256 = "[^"]*"%sha256 = "${{ steps.latest.outputs.hash }}"%; ' \
@@ -42,6 +43,7 @@ jobs:
              -e '  s%url = "[^"]*"%url = "https://github.com/tweag/rules_haskell/releases/download/v${{ steps.latest.outputs.version }}/rules_haskell-${{ steps.latest.outputs.version }}.tar.gz"%' \
              -e '}' \
              start
+          # update http_archive attrs in docs between `name = "rules_haskell"` and `url = "`
           sed -i \
              -e '/name = "rules_haskell"/,/url = "/{' \
              -e '  s%sha256 = "[^"]*"%sha256 = "${{ steps.latest.outputs.hash }}"%; ' \