Skip to content

Document how a release is made - #41

Merged
Art4 merged 1 commit into
masterfrom
add-releasing-docs
Nov 21, 2026
Merged

Art4 merged 1 commit into
masterfrom
add-releasing-docs

Conversation

@Art4

@Art4 Art4 commented Nov 21, 2026

Copy link
Copy Markdown
Member

Summary

 docs/agents/
+└── releasing.md        # the release procedure, eight steps
 AGENTS.md
+    ### Releasing: developer-initiated, never agent-launched; see docs/agents/releasing.md

The procedure follows how the twelve releases so far were made (a release commit that only changes CHANGELOG.md, an X.Y.Z tag without v, a GitHub release, Packagist through its webhook), with the changes agreed with the maintainer:

release path    release-X.Y.Z branch + pull request, merged with a merge commit (was: a commit directly on master)
gate            the merge of the release pull request; tag and GitHub release only by the developer
tag             annotated, on the merge commit of master (was: lightweight)
GitHub release  description is the CHANGELOG section, created right after the tag (was: empty, often later)
checks          make test in Docker, green CI (all PHP matrix jobs and the Roave check), supported-range check
aftermath       check Packagist, then the follow-up tickets #40 and #39

Evidence

  • Before: no written release procedure; the history of the twelve releases was the only description.
    After: the steps with a completion criterion each, and AGENTS.md points to them.

Merge Danger

Door: two-way

Blast Radius: none

Documentation only. It states that a release is never started by an agent.

Describe the release procedure: developer-initiated, prepared through a release pull request, annotated tag and GitHub release by the developer, and the follow-up work after a release.
@Art4
Art4 merged commit b9945dd into master Nov 21, 2026
8 checks passed
@Art4
Art4 deleted the add-releasing-docs branch November 21, 2026 18:30
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