Skip to content

docs(changelog): adopt Keep a Changelog 1.1.0 - #6

Merged
linyiru merged 1 commit into
mainfrom
docs/keep-a-changelog
Sep 9, 2026
Merged

linyiru merged 1 commit into
mainfrom
docs/keep-a-changelog

Conversation

@linyiru

@linyiru linyiru commented Sep 9, 2026

Copy link
Copy Markdown
Member

Adopts https://keepachangelog.com/en/1.1.0/ for packages/groundflare/CHANGELOG.md.

Release flow going forward: move the [Unreleased] entries under a new ## [X.Y.Z] - date heading and add its compare link.

Add the standard preamble, an [Unreleased] section covering #3, #4 and
#5 (Node floor declared as 22.13, Vitest 5, oxlint/oxfmt, Windows CI
and format enforcement, the Windows test-harness fix), and comparison
links for every version at the bottom.

History is normalised, not rewritten: `## vX.Y.Z — title` becomes
`## [X.Y.Z] - YYYY-MM-DD` with the old title kept as an italic lead
line, dates taken from the release tags (and from the release commits
for 0.2.0–0.3.0, which predate tagging). 0.5.3 gets a one-line entry:
it was committed but never published to npm. The example README that
deep-linked the old 0.5.0 heading points at the new anchor.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟢 Approval recommended

Documentation-only changes appear internally consistent (headings, anchors, and link references) and should not affect runtime behavior.

Pull request overview

Updates packages/groundflare/CHANGELOG.md to follow the Keep a Changelog 1.1.0 structure and adjusts an example README deep-link to match the new normalized heading anchor.

Changes:

  • Add Keep a Changelog preamble + standardized ## [Unreleased] section and normalize historical release headings to ## [X.Y.Z] - YYYY-MM-DD.
  • Add link reference definitions (compare links / commit links) for each version at the end of the changelog.
  • Update emdash-demo README to deep-link to the new 0.5.0 heading anchor.
File summaries
File Description
packages/groundflare/CHANGELOG.md Adopts Keep a Changelog format with normalized version headings, an Unreleased section, and version link references.
packages/groundflare/examples/emdash-demo/README.md Updates the changelog deep-link to the new normalized 0.5.0 heading anchor.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@linyiru
linyiru merged commit 5e0f91c into main Sep 9, 2026
5 checks passed
@linyiru
linyiru deleted the docs/keep-a-changelog branch September 9, 2026 15:14
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.

2 participants