Skip to content

docs: clarify changelog/versioning rules + fix release-please token comment - #42

Merged
pmaxhogan merged 1 commit into
mainfrom
docs/clarify-changelog-rules
Jun 26, 2026
Merged

pmaxhogan merged 1 commit into
mainfrom
docs/clarify-changelog-rules

Conversation

@pmaxhogan

Copy link
Copy Markdown
Owner

Follow-up polish from the review of the PR-title enforcement work (the gate itself shipped in #39; v0.3.0 is already released). No behavior change - docs + one workflow comment.

Changes

  • CLAUDE.md
    • Changelog-visible types by default are feat/fix/perf/revert/deps, not just feat/fix/perf.
    • Warn that titling a real change with a hidden type (chore:/docs:/ci:/...) passes the title gate but still produces no changelog entry / no version bump - the Comprehensive UI/UX overhaul + tray i18n/icon fix + CLI tests #37 "silently dropped" failure, self-inflicted. Pick the accurate type.
    • State that a breaking change pre-1.0 bumps minor (0.x.0), not major (bump-minor-pre-major).
    • Note squash is the only enabled merge method (why branch commit messages needn't be conventional).
  • .github/workflows/release-please.yml - correct the stale comment: RELEASE_PLEASE_TOKEN is configured, which is what lets pull_request checks (incl. the Validate PR title gate) run on the release PR despite GitHub's GITHUB_TOKEN recursion guard.

🤖 Generated with Claude Code

…omment

Apply review follow-ups on the PR-title/release-please guidance:
- CLAUDE.md: changelog-visible types also include revert + deps (not just
  feat/fix/perf); warn that mislabeling a real change as a hidden type
  (chore/docs/...) passes the title gate but still drops it from the release
  notes - the #37 failure mode, self-inflicted.
- CLAUDE.md: state that a breaking change pre-1.0 bumps minor (0.x.0), not
  major, under bump-minor-pre-major.
- CLAUDE.md: note squash is the only enabled merge method (why branch commit
  messages don't need to be conventional).
- release-please.yml: correct the stale comment - RELEASE_PLEASE_TOKEN IS set,
  which is what lets pull_request checks (incl. the title gate) run on the
  release PR despite GitHub's GITHUB_TOKEN recursion guard.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017GadVxaYAAY1Q5tRMNucrM
@github-actions

Copy link
Copy Markdown
Contributor

Coverage

Area main this PR delta
Rust (lib crates) 76.57% 76.57% +0.00 (OK)
UI (vue/ts) 86.94% 86.94% +0.00 (OK)

Gate: passed - no coverage regression (epsilon 0.1 pp).

@pmaxhogan
pmaxhogan merged commit c21cf81 into main Jun 26, 2026
18 checks passed
@pmaxhogan
pmaxhogan deleted the docs/clarify-changelog-rules branch June 26, 2026 15:36
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