Contributing content

This site is generated by rsites. 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 = "section.html"
page_template = "pages.html"
+++

Home is content/_index.md.
Docs live under content/docs/.
Applicant records live under applicants/*.yaml. Resume pages under content/applicants/ (except _index.md) are generated.
Do not edit themes/ or public/.

After you add or change a page, run python3 scripts/sync-applicants.py then rsites check. Preview with rsites serve.

If you add a top-level section besides Docs and Applicants, add a matching link in [extra.menus] in zola.toml.

Zola runs Tera on Markdown bodies. Wrap literal template tags in a Tera raw block so they are not executed.