clientdocs/ -- client-facing document package (INTERNAL README)
This directory holds everything we hand to a client, separated from internal docs/runbooks by operator ruling (2026-07-06). Everything here is a DRAFT / living document: accurate, but without final client polish.
Rules for this directory:
- No internal identifiers. Decision numbers, fix numbers, ticket ids, internal hostnames/IPs, and runbook names never appear in client documents. (This also keeps these files out of the internal numbering scans.)
- Client language. Second person, no charm/Juju/deployment internals. Internal mechanics live in docs/tenant-onboarding-contract.md, which is the authoritative source these documents are derived from -- when the contract changes, sweep this directory.
- Packaging. A client receives a copy (or export) of the relevant files, never a repo link. Which file goes when:
intake-form.md -- BEFORE onboarding (their homework).
welcome.md + self-service-guide.md -- AT credential handoff.
- ASCII + LF, like everything committed.
Contents: intake-form.md, welcome.md, self-service-guide.md.