Contributing content

Frontmatter and paths for pages on this site.

This site is generated by rsites. Agents should 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/.
  • Do not edit themes/ or public/.

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.