Skip to content

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

Open
CybotTM wants to merge 1 commit into
TYPO3-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 into
TYPO3-Documentation:mainfrom
CybotTM:task/adr-versioning-strategy

Conversation

@CybotTM

@CybotTM CybotTM commented Mar 17, 2026

Copy link
Copy Markdown
Contributor

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

As of July 2026, nine consumer repositories SHA-pin reusable-backport.yml, and their pins have already drifted across two different commits (161f3be vs 46ed94f) — most consumers silently miss the latest workflow fixes. The open migration PRs use @main. This ADR proposes standardizing on @main with clear rationale.

Note

The ADR is a self-contained RST file under Documentation/Decisions/; the repository has no rendered documentation structure yet (the merged #3 turned out to be the README instead), so render/toctree integration can follow separately.

Feedback requested

@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
@CybotTM CybotTM force-pushed the task/adr-versioning-strategy branch from f6c005a to c32c7f8 Compare June 24, 2026 15:30
Signed-off-by: Sebastian Mendel <github@sebastianmendel.de>
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