Authoring Fern MDX documentation pages for the Opik docs site, plus release-note and changelog routing. Use when writing or updating pages under apps/opik-documentation/documentation/fern/, drafting PR descriptions, or picking the right changelog surface.
The Opik docs site is built with Fern from MDX sources under apps/opik-documentation/documentation/fern/. Two content surfaces coexist:
fern/docs/ — v1 (the established surface, source of style truth)fern/docs-v2/ — latest (where new pages go)New pages should land in docs-v2/. v1 is the reference for writing style and component usage because it is far richer.
apps/opik-documentation/documentation/fern/docs-v2/<section>/<page-name>.mdx.fern/versions/latest.yml under the right section: block.fern/versions/v1.yml if the page must also ship in the v1 build (rare).fern/docs.yml when adding a page — that file is the global site config (tabs, redirects), not per-version routing.Every page uses YAML frontmatter. title and headline are required; the og:* fields are strongly recommended for SEO/social sharing and are present on every page. Do not repeat title as an inline # H1 in the body — Fern renders it from frontmatter.
---