The GitHub storage backend (calm.database.mode=github) has no user-facing documentation — no explanation of the namespace-to-repo config surface (calm.github.namespaces, access groups, clone directory), the OAuth-adjacent config, or the read-only/SHA-versioning model it exposes.
Fix: add a docs page (or ADR under calm-hub/decisions/) covering: configuring namespaces and access groups, what read-only mode means for this backend, and how versions work (real SHAs, no semver, no latest).
The GitHub storage backend (
calm.database.mode=github) has no user-facing documentation — no explanation of the namespace-to-repo config surface (calm.github.namespaces, access groups, clone directory), the OAuth-adjacent config, or the read-only/SHA-versioning model it exposes.Fix: add a docs page (or ADR under
calm-hub/decisions/) covering: configuring namespaces and access groups, what read-only mode means for this backend, and how versions work (real SHAs, no semver, nolatest).