Anything in src/content/docs/public/ is visible to everyone, signed in or not — release notes, product
overviews, onboarding guides, anything safe to be fully open.
Document metadata
Every document in this site (public or private) carries the same frontmatter:
| Field | Required | Meaning |
|---|---|---|
title | yes | Page title, also used as the sidebar label. |
description | yes | One-line summary; shown in search results and link previews. |
date | yes | Authoring date. |
created | yes | When the underlying thing being documented was created. |
published_at | yes | When this document was first published. |
updated_at | optional | Last revision date. When set, it wins over published_at for sorting. |
order | optional | Manual position, ascending. Overrides date-based sorting when set. |
The sidebar sorts newest-first using updated_at (falling back to published_at, then date, then
created) — unless a document sets order, in which case ordered documents are pinned ahead of the rest,
sorted ascending among themselves. See src/lib/content-order.ts.