From 0a6008f3caa8531e588cecc6119c564b4b2ab4ff Mon Sep 17 00:00:00 2001 From: BryanFRD Date: Sat, 10 Oct 2026 14:27:19 +0200 Subject: [PATCH] docs(changelog): fix leftovers in five entries --- .../2026-04-29-ferrflow-docs-claude-style.md | 26 +++++++++---------- ...rflow-do-not-track-and-first-run-notice.md | 2 +- .../2026-07-21-ferrflow-hosted-api.md | 2 +- ...26-08-20-ferrflow-version-source-option.md | 2 +- .../2026-08-20-ferrflow-version-source.md | 2 +- .../2026-09-03-ferrflow-docs-public.md | 10 +++---- 6 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/site/changelog/2026-04-29-ferrflow-docs-claude-style.md b/docs/site/changelog/2026-04-29-ferrflow-docs-claude-style.md index 388b75c9..f61a64c1 100644 --- a/docs/site/changelog/2026-04-29-ferrflow-docs-claude-style.md +++ b/docs/site/changelog/2026-04-29-ferrflow-docs-claude-style.md @@ -1,22 +1,22 @@ --- -title: 'FerrFlow: docs au style Claude' -summary: 'ferrflow.com/docs/ adopte le langage visuel de docs.claude.com: fond off-white, accent FerrFlow orange, code blocks soft-dark, callouts à barre accent, layout 3 colonnes, composants //.' +title: 'FerrFlow: docs in the Claude style' +summary: 'ferrflow.com/docs/ adopts the visual language of docs.claude.com: off-white background, FerrFlow orange accent, soft-dark code blocks, accent-bar callouts, a 3-column layout and // components.' date: 2026-04-29T16:30:00Z product: 'ferrflow' type: 'new' --- -La doc Starlight par défaut faisait son boulot mais avait l'air générique. On adopte le langage visuel des docs Anthropic, en gardant l'orange FerrFlow comme accent unique au lieu de la clay Anthropic. +The default Starlight docs did their job but looked generic. They now borrow the visual language of the Anthropic docs, keeping FerrFlow orange as the single accent instead of Anthropic's clay. -Ce qui change visuellement : +What changes visually: -- **Fond off-white `#fafafa`** (light) / **near-black `#0a0a0a`** (dark) avec texte zinc. -- **Inter system stack** pour le corps, Fraunces gardé pour les titres. -- **Accent FerrFlow orange `#e8733a`** (light) / `#ef8a55` (dark) pour les liens, focus rings, sidebar active item. -- **Code blocks soft-dark `#1c1c1c`** même en light mode, 12px rounded, label langue top-left, bouton copy top-right au hover. -- **Callouts à carte teintée** avec barre accent 4px à gauche : ``, ``, ``, ``. -- **Composants Mintlify-style** `` et `` pour les grilles de valeur. -- **Breadcrumb small-caps** "Section › Page" au-dessus du H1. -- **Widget "Was this page helpful?"** + lien "Edit on GitHub" en bas de chaque page. +- **Off-white `#fafafa` background** (light) and **near-black `#0a0a0a`** (dark), with zinc text. +- **Inter system stack** for body text, Fraunces kept for headings. +- **FerrFlow orange accent `#e8733a`** (light) and `#ef8a55` (dark) for links, focus rings and the active sidebar item. +- **Soft-dark code blocks `#1c1c1c`** even in light mode, 12px rounded, language label top-left, copy button top-right on hover. +- **Tinted-card callouts** with a 4px accent bar on the left: ``, ``, ``, ``. +- **Mintlify-style components** `` and `` for value grids. +- **Small-caps breadcrumb** "Section › Page" above the H1. +- **"Was this page helpful?" widget** and an "Edit on GitHub" link at the bottom of every page. -Layout, sidebar versions/langues, ExpressiveCode, FR translations et snapshots `v0/v1/v2/v3` héritent automatiquement (le CSS est global). Pagefind search inchangée. La modale Cmd+K garde son style Starlight pour l'instant. +Layout, version and language sidebar, ExpressiveCode, FR translations and the `v0`/`v1`/`v2`/`v3` snapshots inherit it automatically since the CSS is global. Pagefind search is unchanged. The Cmd+K modal keeps its Starlight style for now. diff --git a/docs/site/changelog/2026-05-05-ferrflow-do-not-track-and-first-run-notice.md b/docs/site/changelog/2026-05-05-ferrflow-do-not-track-and-first-run-notice.md index ff828465..87e0a3b9 100644 --- a/docs/site/changelog/2026-05-05-ferrflow-do-not-track-and-first-run-notice.md +++ b/docs/site/changelog/2026-05-05-ferrflow-do-not-track-and-first-run-notice.md @@ -14,7 +14,7 @@ Two small additions to make the FerrFlow CLI's anonymous telemetry friendlier an **First-run notice.** The first time you run the CLI on a machine, it prints one line to stderr: ``` -Anonymous telemetry on. See https://ferrlabs.com/telemetry: opt out: FERRFLOW_TELEMETRY=0 or DO_NOT_TRACK=1 +Anonymous telemetry on. See https://ferrlabs.com/telemetry — opt out: FERRFLOW_TELEMETRY=0 or DO_NOT_TRACK=1 ``` A marker file in `$XDG_STATE_HOME/ferrflow/.telemetry-notice-shown` (or `~/Library/Application Support/ferrflow/` on macOS, `%LOCALAPPDATA%\ferrflow\` on Windows, override with `FERRFLOW_STATE_DIR`) suppresses it on subsequent runs. We never silently re-enable telemetry between versions; if you opted out, the notice doesn't print and nothing is sent. diff --git a/docs/site/changelog/2026-07-21-ferrflow-hosted-api.md b/docs/site/changelog/2026-07-21-ferrflow-hosted-api.md index 94636463..837fd649 100644 --- a/docs/site/changelog/2026-07-21-ferrflow-hosted-api.md +++ b/docs/site/changelog/2026-07-21-ferrflow-hosted-api.md @@ -1,6 +1,6 @@ --- title: 'FerrFlow: Hosted API for validate, preview, schema and releases' -summary: 'A new hosted API at api.ferrlabs.com/v1/ferrflow/* lets you validate a config, preview version bumps and changelog, fetch the config JSON Schema, and resolve the latest release, over HTTP, with results identical to the CLI.' +summary: 'A new hosted API at api.ferrlabs.com/v1/ferrflow/* lets you validate a config, preview version bumps and changelog, fetch the config JSON Schema, and resolve the latest release over HTTP, with results identical to the CLI.' date: 2026-07-21T16:00:00Z product: ferrflow type: new diff --git a/docs/site/changelog/2026-08-20-ferrflow-version-source-option.md b/docs/site/changelog/2026-08-20-ferrflow-version-source-option.md index 5431b8ee..0295d5a0 100644 --- a/docs/site/changelog/2026-08-20-ferrflow-version-source-option.md +++ b/docs/site/changelog/2026-08-20-ferrflow-version-source-option.md @@ -1,5 +1,5 @@ --- -title: 'FerrFlow · choose whether the tag or the file is the source of truth' +title: 'FerrFlow: choose whether the tag or the file is the source of truth' summary: 'When a package has both a git tag and a version in a versioned file, FerrFlow took whichever was higher. That is still the default, and versionSource now lets a repo say the tags are the record, or that the file is.' date: 2026-08-20T12:00:00Z product: ferrflow diff --git a/docs/site/changelog/2026-08-20-ferrflow-version-source.md b/docs/site/changelog/2026-08-20-ferrflow-version-source.md index 60f6340d..6d6a26b6 100644 --- a/docs/site/changelog/2026-08-20-ferrflow-version-source.md +++ b/docs/site/changelog/2026-08-20-ferrflow-version-source.md @@ -1,5 +1,5 @@ --- -title: 'FerrFlow · release output says where the current version came from' +title: 'FerrFlow: release output says where the current version came from' summary: 'The version FerrFlow starts from is resolved from a tag, a versioned file, or neither. The release and check output now names the source, so a package whose tag was never pushed is distinguishable from one that has no tags yet.' date: 2026-08-20T10:00:00Z product: ferrflow diff --git a/docs/site/changelog/2026-09-03-ferrflow-docs-public.md b/docs/site/changelog/2026-09-03-ferrflow-docs-public.md index 430fcc6d..2edd6104 100644 --- a/docs/site/changelog/2026-09-03-ferrflow-docs-public.md +++ b/docs/site/changelog/2026-09-03-ferrflow-docs-public.md @@ -1,17 +1,17 @@ --- title: 'FerrFlow: the documentation is now open to pull requests' -summary: 'The pages behind ferrflow.com/docs moved to a public repo. A wrong flag name, a stale example or a paragraph that never quite landed can now be fixed by anyone, and the fix goes live when it merges.' +summary: 'The pages behind ferrflow.com/docs live in the public FerrFlow repository. A wrong flag name, a stale example or a paragraph that never quite landed can now be fixed by anyone, and the fix goes live when it merges.' date: 2026-09-03T09:00:00Z product: ferrflow type: new prLink: https://github.com/FerrLabs/FerrFlow-Cloud/pull/908 -docsLink: https://github.com/FerrLabs/FerrFlow-Docs +docsLink: https://github.com/FerrLabs/FerrFlow/tree/main/docs/site --- The FerrFlow CLI has been open source since the start, but its documentation was not. The pages lived in the private repo that builds ferrflow.com, so spotting a mistake in them and being able to fix it were two very different things. -They now live in [FerrLabs/FerrFlow-Docs](https://github.com/FerrLabs/FerrFlow-Docs), which is public and holds markdown and nothing else. Every page served under `/docs`, current and frozen, is in there under `content/`. +They now live in [`docs/site`](https://github.com/FerrLabs/FerrFlow/tree/main/docs/site) of the public FerrFlow repository, next to the code they describe. Every page served under `/docs`, current and frozen, is in there. -To fix something, open a pull request against that repo. The site fetches it at build time, so merging is the whole publication step and there is nothing to do afterwards. +To fix something, open a pull request against that repo. The pages ship in the `@ferrflow/doc` package and the site picks them up at build time, so there is nothing to do once the change is released. -The frozen per-version snapshots came along too, and they stay frozen. `content/docs-v5/` records what FerrFlow v5 actually documented, mistakes included, because anyone still pinned to v5 reads those pages to understand the binary they are running. CI rejects a pull request that edits one and points you at the current docs instead. +The frozen per-version snapshots came along too, and they stay frozen. `docs/site/docs-v5/` records what FerrFlow v5 actually documented, mistakes included, because anyone still pinned to v5 reads those pages to understand the binary they are running. CI rejects a pull request that edits one and points you at the current docs instead.