Releases go to RubyGems (ruby2html) and are tagged vX.Y.Z on GitHub (sebyx07/ruby2html).
Merging a version bump to main is the release. When lib/gem/ruby2html/version.rb changes on
main and tag vX.Y.Z does not exist yet, .github/workflows/release.yml:
- checks that
CHANGELOG.mdhas a## [X.Y.Z]section, then runs compile,rspec, rubocop andrake smoke, plus a JRuby install; - publishes the gem (RubyGems trusted publishing, GitHub environment
release; no API key in the repo); - only then creates the tag and the GitHub release, with the
.gemattached and notes frombin/changelog-notes.
Nobody tags or gem pushes by hand. The developerz.ai maintainer agent judges each week whether a release
is needed and opens the release PR (.dz/schedules/release-due.md); a security fix a first-tier source
confirms goes out off-cycle (.dz/schedules/security-release.md). A major release is the owner's call: the
agent never opens one.
- Pick the version (SemVer): patch for fixes; minor for new tags/helpers/options, perf work or intentional output changes; major for removed or renamed public API, or a raised Ruby/Rails floor.
lib/gem/ruby2html/version.rb→VERSION = 'X.Y.Z'(the gemspec reads it).CHANGELOG.md: move## [Unreleased]into## [X.Y.Z] - YYYY-MM-DD(with "Upgrading to X.0" for a major), leave an empty## [Unreleased], add the[X.Y.Z]link at the bottom.bin/changelog-notes X.Y.Zmust print the section.- Refresh the issue-template versions placeholder in
.github/ISSUE_TEMPLATE/bug_report.yml: gem version fromlib/gem/ruby2html/version.rb, Ruby version from.ruby-version, Rails version fromGemfile.lock. GitHub issue forms cannot derive the value at fill time, so it is updated here. - Verify:
bundle exec rake compile && CI=1 bundle exec rspec && bundle exec rubocop && bundle exec rake smoke. - One PR titled
release: X.Y.Z, containing nothing else (apart from the issue-template placeholder refresh in step 4). Merge on green.
gh run list --workflow release.yml --limit 1;gem list -r ruby2htmlshows X.Y.Z; the GitHub release exists.- Failed before publishing: fix on
mainand re-run the workflow (workflow_dispatch); it releases whatever version has no tag yet. - Failed after publishing (gem is out, tag missing): re-run the workflow; never reuse or bump past a published version to "fix" it.
gem yankonly by the owner.
- rubygems.org → gem
ruby2html→ Trusted publishers → GitHub Actions: repositorysebyx07/ruby2html, workflowrelease.yml, environmentrelease.