Skip to content

DEV: Prepare the 0.3.0 release#65

Merged
gschlager merged 3 commits into
mainfrom
prepare-0-3-0-release
Jul 9, 2026
Merged

DEV: Prepare the 0.3.0 release#65
gschlager merged 3 commits into
mainfrom
prepare-0-3-0-release

Conversation

@gschlager

Copy link
Copy Markdown
Member

Everything the 0.3.0 release needs except the version bump itself (that stays a single DEV: Bump version to 0.3.0 commit on main once this is in).

  • PERF: bucket for the release notes script — this is the second commit from the release-notes branch; the DEV: Expand squash-merged commits in release notes #63 squash caught the branch before this commit existed, so main's script currently drops all nine PERF: lines from the notes. With it, the next release gets the ⚡ Performance section.
  • Release skill (.claude/skills/release/SKILL.md) — documents the flow: bump lib/markbridge/version.rb, bundle install for the lockfile, one two-file commit, push to main; CI publishes the gem, tags, and creates the GitHub release from bin/generate-release-notes. Also states that merging PRs is never part of releasing.
  • UPGRADING.md section for 0.3.0 — the AST::Quote field renames and Integer typing, the TextFormatter attribution change for id-based quotes, the bare/relative URL rendering changes, and the String-only tag contract with interface.render_default as the fall-through.

Release-notes preview for 0.3.0 with this merged: 3 Features + 1 Fix (#62) and 9 Performance entries (#58#61).

gschlager added 3 commits July 9, 2026 22:07
Documents the release flow (version bump + bundle install + one
commit; CI publishes the gem, tags, and creates the GitHub release
with bin/generate-release-notes) so the next release doesn't need
archaeology. Also states the ground rules: merging PRs is never part
of releasing, and nothing gets pushed to main without approval.
Performance work was invisible in release notes because it carried
DEV: prefixes — but a 2x parser speedup is user-facing for a gem.
PERF: commits (and squash-body bullets) now land in their own
"⚡ Performance" section, after Features and Bug Fixes.
The AST::Quote field renames (post/topic → post_number/topic_id, plus
new post_id/user_id, all Integer), the TextFormatter attribution
change for id-based quotes, the bare/relative URL rendering changes,
and the new String-only tag contract with render_default as the
fall-through.

Also pins the pre-existing "0.x" heading of the migration-API
redesign section to 0.2.0 — the release that actually shipped it
(placeholder from before the version was decided).
@gschlager gschlager force-pushed the prepare-0-3-0-release branch from 7a188fe to 45ed3d0 Compare July 9, 2026 20:29
@gschlager gschlager marked this pull request as ready for review July 9, 2026 20:31
@gschlager gschlager merged commit 5d8f8db into main Jul 9, 2026
8 checks passed
@gschlager gschlager deleted the prepare-0-3-0-release branch July 9, 2026 20:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant