Skip to content

Commit 7b77fb5

Browse files
committed
Note mdsmith's immutable releases in the pinning guidance
Distinguish mdsmith's immutable release tags from the floating @v0 convenience tag: a release-tag pin like @v0.41.0 is a safe, reproducible alternative, while only @v0 moves by design. The commit SHA stays the strongest pin because it can never move. https://claude.ai/code/session_01TKgJTS4UcFPqtdwkxYzTUC
1 parent 9765760 commit 7b77fb5

1 file changed

Lines changed: 8 additions & 5 deletions

File tree

docs/development/release-channels/github-actions.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,11 +50,14 @@ later step can call it. `working-directory` sets the
5050
directory the `args` command runs in. The action exposes
5151
one output, `version`, the string `mdsmith version` prints.
5252

53-
Pin `uses:` to a full-length commit SHA, not a tag. A SHA
54-
is immutable; a tag like `@v0` can be repointed at new
55-
code. GitHub recommends the SHA form, and this repository
56-
uses it for every third-party action. Keep the version in
57-
a trailing comment, as `# v0.41.0` above.
53+
Pin `uses:` to a full-length commit SHA for the strongest
54+
guarantee: a SHA can never move. mdsmith publishes
55+
immutable releases, so a release-tag pin like `@v0.41.0`
56+
is a safe, reproducible alternative. Only the floating
57+
`@v0` tag moves by design. GitHub recommends the SHA form,
58+
and this repository uses it for every third-party action.
59+
Keep the version in a trailing comment, as `# v0.41.0`
60+
above.
5861

5962
The action still verifies the downloaded binary's SHA-256
6063
against the release `checksums.txt`. So the action and the

0 commit comments

Comments
 (0)