Skip to content

docs: require issue/PR references in changelog entries#632

Open
isaacschepp wants to merge 2 commits intomainfrom
docs/changelog-references-v2
Open

docs: require issue/PR references in changelog entries#632
isaacschepp wants to merge 2 commits intomainfrom
docs/changelog-references-v2

Conversation

@isaacschepp
Copy link
Copy Markdown
Collaborator

Summary

Fixes #389 (Phase 1 + Phase 2)

Replaces #625 (which was contaminated with unrelated commits from feat/research-block-schema)

Test plan

  • Verify CLAUDE.md changelog section includes the new reference requirement
  • Verify CONTRIBUTING.md PR process step 6 includes the new reference requirement
  • Verify all [Unreleased] entries in CHANGELOG.md now have issue/PR references
  • Confirm make check-links passes (no broken links introduced)

Update CLAUDE.md and CONTRIBUTING.md to mandate that every changelog
entry includes an issue or PR reference. Add missing references to the
four [Unreleased] entries that lacked them: Non-Gregorian calendar
support (#564), glx merge (#264), glx migrate (#360), and born/died
property removal (#360).

Fixes #389
@isaacschepp isaacschepp added the tooling Infrastructure, workflow, and developer tools label Apr 2, 2026
Copilot AI review requested due to automatic review settings April 2, 2026 21:07
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages bot commented Apr 2, 2026

Deploying genealogix with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4ea0386
Status: ✅  Deploy successful!
Preview URL: https://fd9d2fbb.genealogix.pages.dev
Branch Preview URL: https://docs-changelog-references-v2.genealogix.pages.dev

View logs

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates contributor guidance and the Unreleased changelog entries to ensure user-facing changes are traceable to an issue or PR.

Changes:

  • Add a “reference required” rule for changelog entries to CLAUDE.md and CONTRIBUTING.md.
  • Add missing PR references to four [Unreleased] entries in CHANGELOG.md.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
CONTRIBUTING.md Updates PR checklist to require an issue/PR reference in each changelog entry.
CLAUDE.md Adds the same changelog reference requirement to the internal contributor guide.
CHANGELOG.md Appends PR references to four Unreleased entries (non-Gregorian dates, merge, migrate, born/died removal).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Accept all common reference formats (Fixes #N, Closes #N, bare #N,
parenthesized) instead of implying only parenthesized forms are valid.
Addresses Copilot review feedback.
@isaacschepp isaacschepp requested a review from noahbjohnson April 2, 2026 22:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tooling Infrastructure, workflow, and developer tools

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CHANGELOG: add issue/PR references to all entries

2 participants