Skip to content

docs: replace release_note.md with CHANGELOG.md (Keep a Changelog) - #112

Open
t0kubetsu wants to merge 1 commit into
D4-project:mainfrom
t0kubetsu:docs/changelog-standardize
Open

docs: replace release_note.md with CHANGELOG.md (Keep a Changelog)#112
t0kubetsu wants to merge 1 commit into
D4-project:mainfrom
t0kubetsu:docs/changelog-standardize

Conversation

@t0kubetsu

@t0kubetsu t0kubetsu commented May 19, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Replaces the ad-hoc release_note.md with CHANGELOG.md following the Keep a Changelog 1.1.0 standard
  • All three releases fully migrated with proper section mapping
  • Adds version comparison links at the bottom for diff navigation

Problems with the old format

Issue Details
Inconsistent headers ## Changes, ## v0.xxx.0 Features, ## New Feature varied by release
Marketing version names "MarmotUp Release - v0.2604.0" is not machine-readable
No dates Released versions had no YYYY-MM-DD date
Non-standard Incompatible with release-drafter, git-cliff, and similar tooling

Migration mapping

Old section New section
## Changes / ## Features (new capability) ### Added
## Bugfix / fixes ### Fixed
Renamed / refactored items ### Changed
Current Limitations ### Known Limitations

File changes

  • CHANGELOG.md — created, full content migrated
  • release_note.md — deleted

Test plan

  • CHANGELOG.md renders correctly on GitHub
  • All three releases ([Unreleased], [0.2604.0], [0.2510.0]) are present
  • Compare links at the bottom resolve correctly

Closes #111

Migrates all release history from the ad-hoc release_note.md into a
CHANGELOG.md following keepachangelog.com/en/1.1.0/ conventions:
- ## [Unreleased] header for in-progress changes
- ## [version] - YYYY-MM-DD for each release
- Sections: Added, Changed, Fixed, Known Limitations
- Compare links at the bottom for diff navigation

Content fully migrated from three releases: Unreleased, 0.2604.0, 0.2510.0.

Closes D4-project#111
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.

docs: standardize release notes to Keep a Changelog format

1 participant