Runbooks in repos straw man proposal
- discovery of repos that contain docs - how. pull or push model
- default docs folder name & structure. Coexistence with other docs?
- discourage linking to people & teams? (Too hard to bulk change?)
- how to avoid having to list refs to each .md file
- how to put properties related to a md file with the content e.g. failOverInfo = free text field => md file failOverType = enum => ... front matter in md file?
code: biz-ops-admin implementsPatterns: - api-gateway - heroku-app name: ... dependencies: - biz-ops-api troubleshooting: docs/troubleshooting.md
How patterns work
Records in biz-ops which implement [a subset of] System type
Runbooks exist for
System runbooks link to pattern runbooks