docs(decisions): ADR-0007 release & publication flow#430
Merged
Conversation
Formalize the repo-class release policy the release runbook was waiting on: semantic tags vX.Y.Z are the publication boundary for versioned tools/packages, released via the simple tag-driven zunit pattern (not release-please). zi and other git-consumed repos stay validation-only. Links zsh-lint#21, zsh#8, zi#346.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR formalizes the z-shell release/publication policy by adding an accepted ADR and wiring the release runbook to that decision, clarifying that semantic tags (vX.Y.Z) are the publication boundary for versioned tools/packages and that the preferred mechanism is the simple tag-driven zunit pattern (not release-please).
Changes:
- Adds ADR-0007 (ACCEPTED) documenting repository release classes and the tag-driven release mechanism for versioned tools/packages.
- Updates
runbooks/release.mdto reference ADR-0007 as the governing decision for release/publication flow.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
runbooks/release.md |
Adds a prominent reference to the newly accepted ADR that defines the org’s release/publication boundary and preferred mechanism. |
decisions/0007-release-publication-flow.md |
Introduces ADR-0007, defining repository classes and the tag-driven release standard for versioned tools/packages. |
Comment on lines
+5
to
+9
| > This runbook implements the decision recorded in | ||
| > [`decisions/0007-release-publication-flow.md`](../decisions/0007-release-publication-flow.md) | ||
| > (**ACCEPTED**): semantic tags `vX.Y.Z` are the publication boundary for | ||
| > versioned tools/packages, released via the simple tag-driven `zunit` pattern | ||
| > (not `release-please`). The repo classes below are the authoritative reference. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Formalizes the release/publication policy
runbooks/release.mdwas explicitly waiting on (ZSH-2).vX.Y.Zare the publication boundary for versioned tools/packages (zunit,zsh-lint, packagedzsh); released via the simple tag-drivenzunitpattern, notrelease-please. Continuously-deployed (wiki/src/zd) and git-consumed (zi, plugins/annexes) repos keep their existing models.ziuntouched — itsnext→main→tagboundary is governed by the policy, but no zi workflow/code change is made.Companion PR adds the tag-driven
release.ymltozsh-lint(notes-only, no artifact).zsh#8deferred pending artifact clarification.