Skip to content

Changelog page from keel Releases + Get Started refresh (browser setup, WAL) + land EN revision, verify share-readiness #41

Description

@eaitbrahim

What

Three workstreams, one goal: the site tells the engine's current story and the trilingual revision is fully live.

1. Changelog page (like docs.jesse.trade/docs/changelog)

  • New page /{en,ar,fr}/changelog/ fed at build time from CodeGateSoftware/keel/releases — extend scripts/fetch-release.mjs to fetch the release list and write each body into a (gitignored) content collection, rendered by Astro's markdown pipeline (same pattern as the engine docs, no new dependency).
  • Design per Jesse's model, in our own style: one page, newest first, per-release heading vX.Y.Z — date with anchors, an on-this-page version TOC, link to GitHub per release.
  • Honesty: release notes stay in English (canonical); ar/fr pages translate the chrome and say so. Graceful fallback to a Releases link when the fetch yields nothing. Nav entry after News.

2. Get Started refresh

Engine main (25 commits ahead of v0.10.0) added: double-clickable macOS app (keel.app), keel serve browser view, first-run checklist + credential form with OS-keychain storage, market data as a background job, attest/promote from the browser (#469), and SQLite WAL mode (#470). None of that is in a release yet — v0.10.0 ships wheels only. The Get Started copy must say exactly that: browser-first setup is on main and lands in the next release; today's download remains the terminal-first path. AR/FR mirrored, revs bumped.

3. Land the EN revision + verify

Acceptance

  • /en/changelog/ (+ar/fr) live, listing all releases newest-first with anchors and TOC
  • Header nav links the changelog in all locales; Install page links the full history
  • Get Started mentions browser setup + WAL honestly (on main / next release)
  • docs(i18n): copy-edit the English to newspaper style #39 merged; trilingual revision deployed and verified
  • Site passes the readiness sweep; this issue closes the remaining pre-share gaps

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions