[FEATURE] Include GitHub issue numbers in release notes / changelog
Resolved 💬 3 comments Opened Jan 29, 2026 by carrotRakko Closed Mar 1, 2026
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
When a bug is fixed or a feature request is implemented, reporters have no way to know:
- Which release includes their fix
- Whether their reported issue was actually addressed
The only current signals are:
- Issue being closed (sometimes with "fixed" label, sometimes not)
- General release notes that describe changes but don't link back to issues
This creates a disconnect between the issue tracker and the changelog. Reporters must either:
- Manually check each release note looking for their issue
- Keep their issue open indefinitely to ask "was this fixed?"
Related: #15692 discusses this feedback loop gap.
Proposed Solution
Include GitHub issue numbers in release notes when a fix or feature addresses a reported issue.
Example changelog entry:
### Bug Fixes
- Fixed race condition in file watcher (#XXXXX)
- Resolved terminal rendering issue on Windows (#YYYYY, #ZZZZZ)
This provides:
- Automatic notification to reporters (GitHub notifies on issue mention)
- Traceability between releases and issues
- Credit to reporters who took time to file issues
Alternative Solutions
- Close issues with "fixed in vX.Y.Z" comment: Requires manual effort per issue
- Public roadmap with issue links: Helpful but separate from release flow
- Do nothing: Reporters remain in the dark
Priority
Medium - Would be very helpful
Feature Category
Documentation
Use Case Example
- User reports bug with detailed reproduction steps
- Anthropic fixes the bug internally
- New version is released with changelog entry: "Fixed file watcher race condition"
- User sees changelog but can't tell if their specific issue was addressed
- User comments on their issue: "Was this fixed? Which version?"
With issue numbers in changelog:
- Step 3 becomes: Changelog entry includes issue number
- User gets GitHub notification automatically
- User knows exactly which version to update to
- No follow-up comment needed
Additional Context
Prior art:
- Most OSS projects include issue numbers in changelogs (React, Vue, TypeScript, etc.)
- GitHub automatically linkifies issue references
- Conventional Commits spec recommends issue references
Cost:
- Minimal: just include issue number in changelog entries
- Can be added to existing release workflow
Benefit:
- Closes feedback loop automatically via GitHub notifications
- Builds trust: "my issue was heard and fixed"
- Reduces "is this fixed?" comments on issues
---
✍️ Author: Claude Code (Dev Container) with @carrotRakko
Note: This issue was written and submitted by an AI agent (Claude Code), with human review and approval.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗