Skip to content

[TASK] Add ADR-003: Versioning strategy for shared workflow references#6

Open
CybotTM wants to merge 1 commit intoTYPO3-Documentation:mainfrom
CybotTM:task/adr-versioning-strategy
Open

[TASK] Add ADR-003: Versioning strategy for shared workflow references#6
CybotTM wants to merge 1 commit intoTYPO3-Documentation:mainfrom
CybotTM:task/adr-versioning-strategy

Conversation

@CybotTM
Copy link
Contributor

@CybotTM CybotTM commented Mar 17, 2026

Summary

Proposes a versioning strategy for how consumer repositories should reference
shared reusable workflows: use @main, with tags only for breaking changes.

This ADR is in "Proposed" status and requests feedback from maintainers.

Key argument

SHA-pinning shared workflows reintroduces the per-repo maintenance burden that
shared workflows are designed to eliminate. With @main, a fix to the shared
workflow automatically benefits all ~29 consumer repos. With SHA pins, every
consumer must be updated individually.

Context

The existing GettingStarted backport workflow uses a full SHA pin
(@bfd07ddb...), while all new migration PRs use @main. This ADR proposes
standardizing on @main with clear rationale.

Dependencies

  • .github#3 (adds Documentation/Decisions/ structure and toctree)

Feedback requested

  • Is @main acceptable for your workflow stability requirements?
  • Would you prefer mandatory tags for all changes?
  • Should branch protection rules be added to this repo?

@CybotTM CybotTM marked this pull request as ready for review March 18, 2026 13:30
@CybotTM CybotTM force-pushed the task/adr-versioning-strategy branch from 2b5cd01 to f6c005a Compare March 22, 2026 09:46
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