Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions docs/site/changelog/2026-04-29-ferrflow-docs-claude-style.md
Original file line number Diff line number Diff line change
@@ -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 <Card>/<CardGroup>/<Note>.'
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 <Card>/<CardGroup>/<Note> 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 : `<Note>`, `<Tip>`, `<Warning>`, `<Info>`.
- **Composants Mintlify-style** `<Card>` et `<CardGroup cols={2|3}>` 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: `<Note>`, `<Tip>`, `<Warning>`, `<Info>`.
- **Mintlify-style components** `<Card>` and `<CardGroup cols={2|3}>` 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.
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion docs/site/changelog/2026-07-21-ferrflow-hosted-api.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/site/changelog/2026-08-20-ferrflow-version-source.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
10 changes: 5 additions & 5 deletions docs/site/changelog/2026-09-03-ferrflow-docs-public.md
Original file line number Diff line number Diff line change
@@ -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.
Loading