📚
Docs-as-code
Every repo keeps its documentation in docs/*.md, next to the code. Git provides versioning and dates; the MR provides review and approval.
Versioned in git, approved by MR, published by CI.
Every repo keeps its documentation in docs/*.md, next to the code. Git provides versioning and dates; the MR provides review and approval.
Aggregated pages show their source repo, the commit and the date of the last update. A page without provenance breaks the build.
Authentication, code review criteria, service runbooks and deploy processes — the content that belongs to no single repo.
Confluence keeps product content. Bridge pages link into this portal so nobody loses the thread.