Skip to content

feat(changelog): every keel release, newest first, straight from GitHub Releases - #42

Merged
eaitbrahim merged 1 commit into
mainfrom
changelog-page
Aug 20, 2026
Merged

feat(changelog): every keel release, newest first, straight from GitHub Releases#42
eaitbrahim merged 1 commit into
mainfrom
changelog-page

Conversation

@eaitbrahim

Copy link
Copy Markdown
Contributor

Closes the changelog workstream of #41 (not the whole issue).

What

  • scripts/fetch-release.mjs now also fetches the full release list and writes one markdown file per release into a gitignored changelog content collection — the engine-docs pattern, no new dependency. Headings in each body are demoted one level so the version heading owns the section.
  • New /{en,ar,fr}/changelog/: newest first, per-release anchor headings (#v0-10-0), date + GitHub link, an on-this-page TOC of every version, a chip on the newest.
  • Release notes stay in English — the canonical wording — on every locale; ar/fr translate the chrome and say so (same policy as engine docs, FR-7/8).
  • Nav link after News in all three locales; Install page links the full history; graceful fallback to the Releases page when the fetch yields nothing.

Verified locally

  • npm run build: 44 pages (3 new), 25 releases fetched, TOC + anchors + latest chip present in the emitted HTML.
  • npm run check: 0 errors.

Design modeled on docs.jesse.trade/docs/changelog (version + date headings, newest first, on-this-page TOC) in this site's own style.

…ub Releases

/{en,ar,fr}/changelog/ renders the full release list fetched at build time
into a gitignored content collection — the same never-hand-copied pattern
as the engine docs, no new dependency. Each release gets a version heading
with an anchor, its date, a GitHub link, and the canonical English notes
with headings demoted one level beneath it; an on-this-page TOC lists every
version and the newest carries a chip. ar/fr translate the chrome and say
the notes are English (the engine-docs policy, FR-7/8). A failed fetch
degrades to a plain Releases link, never a broken build.

Nav gains the page after News in all three locales; the Install page links
the full history under the requirements line.

Refs #41
@sonarqubecloud

Copy link
Copy Markdown

Quality Gate Failed Quality Gate failed

Failed conditions
4.4% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud

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