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:

FieldRequiredMeaning
titleyesPage title, also used as the sidebar label.
descriptionyesOne-line summary; shown in search results and link previews.
dateyesAuthoring date.
createdyesWhen the underlying thing being documented was created.
published_atyesWhen this document was first published.
updated_atoptionalLast revision date. When set, it wins over published_at for sorting.
orderoptionalManual 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.