Skip to content

chore: graduate to a stable release - #218

Merged
derrickmehaffy merged 1 commit into
mainfrom
chore/graduate-to-stable
Aug 14, 2026
Merged

chore: graduate to a stable release#218
derrickmehaffy merged 1 commit into
mainfrom
chore/graduate-to-stable

Conversation

@derrickmehaffy

Copy link
Copy Markdown
Contributor

The open release PR proposes 5.1.1-beta, not 5.1.0.

release-please does not graduate off a prerelease on its own — the default
versioning strategy keeps the suffix, so 5.1.0-beta plus a fix: becomes
5.1.1-beta.

Release-As: in the commit message fixes it for that one release, and leaves
nothing behind in the config (unlike the release-as config key, which would
pin every subsequent release to the same version).

Why it needs its own commit

I put the footer in #216's pull request body and it was dropped. GitHub only
builds a squash commit from the title and body when the branch has more than one
commit; with a single commit it uses that commit's own message.

So here the footer is in the commit message itself. This PR must keep a single
commit
for that to survive — if it grows a second, the squash message comes
from this description instead, which also carries the footer, so either way it
lands.

That trap is now written into the release skill.

Answering the question directly

No, this is not needed again. It exists only to cross from 5.1.0-beta to
5.1.0. Once the manifest holds a stable version, release-please computes each
release from the conventional commits since the last one, and no footer is
involved.

What to watch after merging

The release PR should flip to chore: release 5.1.0. Merging that is the
real test: release-please should create the draft by itself, which is what
separate-pull-requests: false was preventing.

The last release was 5.1.0-beta and release-please does not graduate on its
own: the default versioning strategy keeps the prerelease suffix, so the open
release PR proposed 5.1.1-beta rather than 5.1.0.

Release-As applies to a single release and leaves nothing in the config, unlike
the "release-as" config key which would pin every subsequent release.

The footer was in #216's pull request body and did not survive. GitHub only
builds a squash commit from the title and body when the branch has more than
one commit; with a single commit it uses that commit's message. It is recorded
in the release skill so the next person does not lose an hour to it.

Release-As: 5.1.0
@derrickmehaffy
derrickmehaffy merged commit 9306961 into main Aug 14, 2026
12 checks passed
@github-actions github-actions Bot mentioned this pull request Aug 14, 2026
@derrickmehaffy
derrickmehaffy deleted the chore/graduate-to-stable branch August 14, 2026 05:45
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