docs: recommend the @v1 release tag for reusable-workflow consumers (#12)

2026-06-28 04:17:19 +00:00
parent 0d80ae73d8
commit 8f69e71311
3 changed files with 15 additions and 11 deletions
@@ -312,8 +312,10 @@ examples/              the ~15-line stub a consuming repo drops in

 The image is published to `gitea.stevedudenhoeffer.com/steve/gadfly`. Every push to `main`
 rebuilds and republishes `:latest` (plus `:sha-<short>`); pushing a `v*` tag publishes that
-pinned version (plus `:latest`). Pin consumers to a `:vN` tag for stability, or track
-`:latest` to ride main.
+pinned version (plus `:latest`). Pin full-stub consumers to a `:vN` image tag for stability, or track
+`:latest` to ride main. Reusable-workflow consumers likewise pin the workflow ref —
+`review-reusable.yml@v1` (a curated tag moved on releases, so central swarm tuning propagates) or
+a full `@<sha>` for an immutable pin; avoid `@main`.

 ## Configuration (advanced)