docs(changelog): date entries by when they land, add the two missing ones - #143
Merged
Merged
Conversation
The changelog records when *this spec* changed, not when the world did, so `date` is the day the entry lands on main. Three entries kept the date their PR was authored (28th, 28th, 30th) though all three merged on the 31st. - Re-date tdmrep, mcp-handshake and websub to 2026-07-31, renaming each file so the stem still matches. All three went live under an hour ago, so the GUID churn this causes in the changelog feed is as small as it will ever be. - Add a `changed` entry for ARIA in HTML reaching Recommendation and "Using ARIA" being discontinued (#138). - Add a `changed` entry for the expired aipref attachment draft (#131). That one was merged unlogged; it rewrote what the page says about the topic's standing, which is not a citation repair. - Record the dating rule in CLAUDE.md, including why renaming a live entry is not free: the filename stem is `entry.id`, which is both the `<li>` anchor and the feed's `#`-link. Deliberately not logged: #122 (worked-example callout gained a sentence; the recommendation did not move) and #141 (plumbing, and the hub is not live — fold it into the WebSub entry when D1 is provisioned). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Deploying specification-website with
|
| Latest commit: |
5a9fe47
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://d79dd1b2.specification-website.pages.dev |
| Branch Preview URL: | https://chore-changelog-land-dates-2.specification-website.pages.dev |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The changelog records when this spec changed, not when the world did — so
dateis the day the entry lands onmain.Re-dated three entries
All three merged today, but carried the date their PR was authored:
tdmrepmcp-2026-07-28→mcp-handshakewebsubard-catalog-unsignedwas already 31 July.Renaming is not free, which is why now. The filename stem is
entry.id, and that is both the<li>anchor on/changelog/and the#-link the RSS feed emits — so renaming a live entry re-delivers it to subscribers as a new item. These three have been live for under an hour, so the churn is as small as it is ever going to be. I verified the six anchors in the builtdist/changelog/index.htmlmatch the six<link>s indist/changelog/rss.xmlexactly.I also renamed
2026-07-28-mcp-2026-07-28.mdto2026-07-31-mcp-handshake.md— the old name carried two dates meaning different things, which is exactly the confusion this PR is fixing.Two new entries
ARIA in HTML (
changed) — covers #138. "Using ARIA" was discontinued and lists four rules, not the five the page claimed; ARIA in HTML reached Recommendation on 15 April 2026.aipref attachment draft (
changed) — covers #131, which merged unlogged. I under-called this at the time: it is not a citation repair. It replaced one paragraph with three and changed what the page says about the topic's standing — the same shape as the MCP entry that was logged.Deliberately not logged
addedentry already covers the page; better to extend its body once the hub is actually live.CLAUDE.md
The dating rule is now written down, along with the reason renaming a live entry has a cost, so the next agent re-dates before merging rather than after.
Checks
npm run build✓ ·npm run format:check✓ ·npm run check:skill✓ (166 pages) · anchors verified against feed links in the built output🤖 Generated with Claude Code