CI

Documentation for the meta-pantavisor CI system: how workflows are organized, how machines and builds are driven from machines.json, and how releases and docs are published.

Topics

1. Overview — workflow map showing how tag pushes trigger sync, release builds, pvtest runs, and artifact uploads
2. Machines — the .github/machines.json schema and how to add or modify a machine; always run makeworkflows after editing
3. Builds — per-machine build workflows, sstate sharing, S3 artifact layout, and badge generation
4. Status — reading build status badges and CI run summaries
5. Tag Sync — how meta-pantavisor tags are mirrored to pantavisor/pantavisor and the PAT setup required
6. Changelog — per-release CHANGELOG-NNN.md generator: format, tag conventions, and regen procedure

Key Rule

Always run .github/scripts/makeworkflows after editing .github/machines.json. Commit machines.json and the generated workflow files together.