WORK-644
ID:WORK-644Status:done

Backfill release notes and review milestone fallbacks

Once the generator handles notes, the existing page needs content in the summary slot where the milestone fallback is missing or reads badly. See the migration table in SPEC-176.

Priority:mediumComplexity:simpleMilestone:v0.41.1Source:SPEC-176
main View source

Criteria completion

Criteria completion: 5 of 5 (100%) checked; tracking started on Oct 16, no incremental history yet0%25%50%75%100%Oct 16Oct 28

Tracking started Oct 16 — check back for trends.

Relationships

Implements 1
Related 4
Branches 2
main current done
claude/site-changelog-readability-k4p902 donemain done

Acceptance Criteria

  • Handwritten notes exist for v0.39.0, v0.40.0 and v0.41.0, each with an action-needed block where that release requires a change from users
  • v0.4.0 to v0.9.0 each have a one-line note linking their whats-new-in-0-x blog post
  • Each of the 38 milestone openings used as a fallback has been read on the rendered index, and those that do not read as a summary have a note file instead
  • No milestone file is edited to improve its opening as a summary
  • site/content/releases/ is regenerated and the site builds with no new errors

Approach

The v0.41.0 draft from the session that produced SPEC-176 is the starting point for its note. Those three notes are the examples later releases follow, so keep them short: two or three sentences, an action-needed block only when one is needed, then the background line.

Blocked by

  • WORK-641
  • WORK-642

References

  • SPEC-176 "Scope of the migration".

Resolution

Completed: 2026-10-15

Branch: claude/site-changelog-readability-k4p902 PR: refrakt-md/refrakt#704

What was done

  • releases/notes/: handwritten notes for v0.39.0, v0.40.0 and v0.41.0 with action-needed blocks (snippet wrapper and parentUrl; theme overrides of identity fields; content-unmatched and schema-table coverage).
  • Blog-link notes for v0.4.0 to v0.9.0.
  • Notes for seven milestones whose opening did not read as a summary: v0.36–v0.38 (problem only), v0.24 (scheduling), v0.31 (jargon), v0.11 and v0.12 (list-first, title only). 27 releases keep the milestone fallback.

Notes

  • No milestone file was edited. Claims in the notes were checked against each release's changelog.