Skip to content

docs(changelog): match evo.polaris's changelog format with no date on version headings - #99

Merged
kellymichels merged 1 commit into
masterfrom
docs/changelog-fleet-format
Oct 28, 2026
Merged

kellymichels merged 1 commit into
masterfrom
docs/changelog-fleet-format

Conversation

@kellymichels

Copy link
Copy Markdown
Collaborator

What and why

Kelly, 2026-10-27: every repo's changelog should match evo.polaris's CHANGELOG.txt, newest first, and "no need to include when deployed". zbump cuts a release as zdeploy deploys, so the date on a version heading was the deploy date. The annotated tag still carries it.

  • 12 version headings lose their date. ## v0.0.1.0.23 - 2026-10-23 becomes ## v0.0.1.0.23. Nothing else in a section changes.
  • scripts/plaintext_twins.py underlines a third-level heading with ~, exactly as polaris's md-txt.mjs does, so a release's Added / Fixed groups read as a level below its version in the .txt twin. Every twin is regenerated with the repo's own tool; 2 other twin(s) change only in that underline.
  • The intro now opens with polaris's sentence ("Notable changes to the evomedia.net Token Savers, newest first.") and gains polaris's five-parts paragraph. It does not claim every entry links a pull request, because these entries are written by hand.
  • This change's own line under Unreleased, as the changelog rule asks.

Group order already matched polaris's (Added, Changed, Fixed, Documentation, Maintenance) in every section, so no entries moved.

Keeping it this way

zbump still writes a dated heading at each release until evo.scripts#234 merges. After that it writes the version alone. Merge that one first, or the next release here puts a date back.

Tests

  • python scripts/plaintext_twins.py --check: in sync. tests/PlainTextTwins.Tests.ps1: 3 passed.

Changelog and twins only. Nothing to deploy.

🤖 Generated with Claude Code

… version headings

Kelly, 2026-10-27: every repo's changelog should match evo.polaris's
CHANGELOG.txt, newest first, and "no need to include when deployed".
zbump cuts a release as zdeploy deploys, so the date on a version
heading was the deploy date; the tag still carries it.

- 12 version headings lose their date: "## v..." and nothing after.
- scripts/plaintext_twins.py underlines a third-level heading with ~, as polaris's
  md-txt.mjs does, so a release's Added / Fixed groups read as a level
  below its version in the .txt twin. Every twin is regenerated;
  2 other twin(s) change only in that underline.
- The intro now opens with polaris's sentence ("Notable changes to the
  evomedia.net Token Savers, newest first.") and gains polaris's
  five-parts paragraph. It does not claim every entry links a pull
  request, because these entries are written by hand.
- This change's own line under Unreleased.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kellymichels
kellymichels merged commit bbdf474 into master Oct 28, 2026
1 check passed
@kellymichels
kellymichels deleted the docs/changelog-fleet-format branch October 28, 2026 17:22
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