Skip to content

docs(ci): record SHA-pin decision for org reusable-workflow refs - #44

Open
jdwillmsen wants to merge 1 commit into
mainfrom
fix/jdwlabs-448-pin-reusable-workflows
Open

docs(ci): record SHA-pin decision for org reusable-workflow refs#44
jdwillmsen wants to merge 1 commit into
mainfrom
fix/jdwlabs-448-pin-reusable-workflows

Conversation

@jdwillmsen

Copy link
Copy Markdown
Member

Summary

  • Records the decision for JDWLABS-448: pin org reusable-workflow uses: refs to a full commit SHA rather than @main, since this repo has no tagged releases.
  • Updates the section 4 finding in docs/ci-standards.md to close out the "floating-reference finding is org-wide" item with the resolution, the update mechanism (Renovate's existing github-actions digest tracking, already batched weekly), and the accepted trade-off (no more instant org-wide propagation of a behaviour change).
  • Adds a pointer from .github/workflows/README.md's usage examples to the pinning policy so new callers don't copy the @main example verbatim.

Companion PRs pinning the actual caller references land in apps, deployments, infrastructure, and platform.

Test plan

  • Docs-only change; no CI-executable content modified.
  • Reviewed the updated section for accuracy against the current caller inventory (11 references across 4 repos, re-verified by grep).

Ref: JDWLABS-448

Every delivery repo called this repo's reusable workflows at @main, so a
merge here changed CI behaviour for every caller with no version bump
anywhere. Decision: pin callers to a full commit SHA (this repo has no
tagged releases, so a SHA pin is the immutable option without inventing a
release process) with a dated comment, updated going forward via
Renovate's existing github-actions digest tracking. Updates the section 4
finding in ci-standards.md and adds a pointer from the workflows README.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TrYLd68mqFxfDFuqnPJCy7
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant