Appearance
Product changelog
Release notes by ship date (YYYY-MM-DD in the filename; Friday releases by default). Each week has two pages—frontend and backend—under separate folders so git-based updates never overwrite the other repo’s file.
Layout
| Location | Contents |
|---|---|
changelog/frontend/<YYYY-MM-DD>.md | UI / frontend repo narrative |
changelog/backend/<YYYY-MM-DD>.md | API / backend repo narrative |
Use frontmatter title like April 17, 2026 — Frontend (sidebar label). Stakeholder ## Summary and ## Shipped up front; ## Engineering (commit recap) for themed notes from commits (no per-commit tables unless you want them).
How to add a week
- Copy
changelog/frontend/_release-page.template.mdtochangelog/frontend/<YYYY-MM-DD>.mdandchangelog/backend/_release-page.template.mdtochangelog/backend/<YYYY-MM-DD>.md; replace placeholder dates and titles. - Run the
weekly-repo-changelogskill fromfrontend/andbackend/(or edit by hand). - Build/preview the site from
changelog/site/—new pages are picked up automatically (files starting with_are templates only and stay out of the sidebar).