diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 504cf53..43c72d0 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -35,6 +35,13 @@ name: Release — Tag and GitHub Release
 #       uses: Sea-Haven-Industries/.github/.github/workflows/release.yaml@<full-commit-sha> # main
 #       with:
 #         version: ${{ inputs.version }}
+#
+# This repo's own caller is .github/workflows/release-on-merge.yaml, which
+# computes the version and calls this workflow by local path rather than by
+# SHA. It runs on merges to main that touch a workflow carrying `on:
+# workflow_call`, so a change to a reusable produces a tag other repos can pin
+# to. It is also the one caller that reaches this workflow without a version
+# comment, because a repo cannot usefully pin to a commit of itself.
 
 on:
   workflow_call: