Create high level documentation for our infrastructure
Originally created by @groente on #15096 (Redmine)
The project could benefit from visual high level documentation (flowcharts) giving insight in the different processes that run on our infrastructure. This will make it easier to:
- onboard new people
- analyse problems where multiple parts of the infra interact
- identify points of improvement within the infra
BPMN seems like a good candidate, ideally (at least in part) auto-generated from inline comments in puppet to ensure the documentation stays up-to-date.
For this first iteration:
- set up the framework to write & maintain this documentation, so that our sysadmins can automatically generate locally a useful visualization out of it
- private output, don’t bother about public/private separation
- document the CI setup
Related issues
- Blocks #15097