This site
Page schema for humans and coding agents adding docs to www.burtonapp.com.
This marketing site is generated by rsites (Zola + DevLab). Product facts come from the Burton, Rabun, and Tallulah git repos — not from themes/. Agents should also read AGENTS.md at the site root.
Frontmatter
Pages use TOML fences (+++), not YAML (---).
A documentation article:
+++
title = "Short title"
description = "One sentence."
weight = 10
+++
Write the body in Markdown.
A documentation section (_index.md under content/docs/):
+++
title = "Guides"
description = "How to use the project."
sort_by = "weight"
template = "docs.html"
page_template = "doc-page.html"
+++Paths
- Home is
content/_index.md. - Docs live under
content/docs/. - Brand marks live in
static/brand/(same SVGs as the docs hub). - Do not edit
themes/orpublic/.
After you add or change a page, run rsites check. Preview with rsites serve.
If you add a top-level section besides Docs, add a matching link in [extra.devlab.navigation] in zola.toml.
Tera in Markdown
Zola runs Tera on Markdown bodies. Wrap literal template tags in a Tera raw block so they are not executed.