Guides¶
Guides are practical instructions for recurring infrastructure tasks.
They are intentionally secondary to Infrastructure Areas. Use an area page when you need landscape and status context. Use a guide when you need execution steps.
Guide Topics¶
| Topic | Use this when you need to... | Related Infrastructure Areas |
|---|---|---|
| Repository onboarding | onboard or align a repository with shared conventions | Source Code Infrastructure |
| Repository policies | define or adjust repository governance controls | Source Code Infrastructure |
| Bazel and dependencies | update build behavior, Bzlmod modules, or dependency handling | Build Infrastructure |
| CI workflows | create or refine PR validation and reusable workflows | Integration Infrastructure |
| Artifact publishing | publish reusable outputs with clear lifecycle expectations | Artifact Infrastructure |
| Testing and reporting | improve test execution and reporting quality | Testing Infrastructure |
| License compliance and SBOM | integrate compliance checks into engineering workflows | Security & Compliance Infrastructure |
| Documentation publishing | maintain docs build and publishing reliability | Documentation Infrastructure |
| Infrastructure maintenance | maintain runners, monitoring, and incident handling practices | Infrastructure Operations |
Usage Notes¶
- If you are new to an area, start at the area overview page first.
- If you already know the area and need a procedure, start directly with the guide.
- For progress and open work, use the Infrastructure Development Map.