diff --git a/docs/compliance.md b/docs/compliance/index.md
similarity index 100%
rename from docs/compliance.md
rename to docs/compliance/index.md
diff --git a/docs/compliance-nist.md b/docs/compliance/nist-sp-800-57.md
similarity index 100%
rename from docs/compliance-nist.md
rename to docs/compliance/nist-sp-800-57.md
diff --git a/docs/compliance-pci-dss.md b/docs/compliance/pci-dss.md
similarity index 100%
rename from docs/compliance-pci-dss.md
rename to docs/compliance/pci-dss.md
diff --git a/docs/compliance-soc2.md b/docs/compliance/soc2.md
similarity index 100%
rename from docs/compliance-soc2.md
rename to docs/compliance/soc2.md
diff --git a/docs/ci-pipeline.md b/docs/contributor/ci-pipeline.md
similarity index 100%
rename from docs/ci-pipeline.md
rename to docs/contributor/ci-pipeline.md
diff --git a/docs/qa-test-guide.md b/docs/contributor/qa-test-suite.md
similarity index 100%
rename from docs/qa-test-guide.md
rename to docs/contributor/qa-test-suite.md
diff --git a/docs/test-env.md b/docs/contributor/test-environment.md
similarity index 100%
rename from docs/test-env.md
rename to docs/contributor/test-environment.md
diff --git a/docs/testing-strategy.md b/docs/contributor/testing-strategy.md
similarity index 100%
rename from docs/testing-strategy.md
rename to docs/contributor/testing-strategy.md
diff --git a/docs/demo-advanced.md b/docs/getting-started/advanced-demo.md
similarity index 100%
rename from docs/demo-advanced.md
rename to docs/getting-started/advanced-demo.md
diff --git a/docs/concepts.md b/docs/getting-started/concepts.md
similarity index 100%
rename from docs/concepts.md
rename to docs/getting-started/concepts.md
diff --git a/docs/examples.md b/docs/getting-started/examples.md
similarity index 100%
rename from docs/examples.md
rename to docs/getting-started/examples.md
diff --git a/docs/quickstart.md b/docs/getting-started/quickstart.md
similarity index 100%
rename from docs/quickstart.md
rename to docs/getting-started/quickstart.md
diff --git a/docs/why-certctl.md b/docs/getting-started/why-certctl.md
similarity index 100%
rename from docs/why-certctl.md
rename to docs/getting-started/why-certctl.md
diff --git a/docs/certctl-for-cert-manager-users.md b/docs/migration/cert-manager-coexistence.md
similarity index 100%
rename from docs/certctl-for-cert-manager-users.md
rename to docs/migration/cert-manager-coexistence.md
diff --git a/docs/migrate-from-acmesh.md b/docs/migration/from-acmesh.md
similarity index 100%
rename from docs/migrate-from-acmesh.md
rename to docs/migration/from-acmesh.md
diff --git a/docs/migrate-from-certbot.md b/docs/migration/from-certbot.md
similarity index 100%
rename from docs/migrate-from-certbot.md
rename to docs/migration/from-certbot.md
diff --git a/docs/approval-workflow.md b/docs/operator/approval-workflow.md
similarity index 100%
rename from docs/approval-workflow.md
rename to docs/operator/approval-workflow.md
diff --git a/docs/database-tls.md b/docs/operator/database-tls.md
similarity index 100%
rename from docs/database-tls.md
rename to docs/operator/database-tls.md
diff --git a/docs/runbook-cloud-targets.md b/docs/operator/runbooks/cloud-targets.md
similarity index 100%
rename from docs/runbook-cloud-targets.md
rename to docs/operator/runbooks/cloud-targets.md
diff --git a/docs/disaster-recovery.md b/docs/operator/runbooks/disaster-recovery.md
similarity index 100%
rename from docs/disaster-recovery.md
rename to docs/operator/runbooks/disaster-recovery.md
diff --git a/docs/runbook-expiry-alerts.md b/docs/operator/runbooks/expiry-alerts.md
similarity index 100%
rename from docs/runbook-expiry-alerts.md
rename to docs/operator/runbooks/expiry-alerts.md
diff --git a/docs/security.md b/docs/operator/security.md
similarity index 100%
rename from docs/security.md
rename to docs/operator/security.md
diff --git a/docs/tls.md b/docs/operator/tls.md
similarity index 100%
rename from docs/tls.md
rename to docs/operator/tls.md
diff --git a/docs/openapi.md b/docs/reference/api.md
similarity index 100%
rename from docs/openapi.md
rename to docs/reference/api.md
diff --git a/docs/architecture.md b/docs/reference/architecture.md
similarity index 100%
rename from docs/architecture.md
rename to docs/reference/architecture.md
diff --git a/docs/deployment-atomicity.md b/docs/reference/deployment-model.md
similarity index 100%
rename from docs/deployment-atomicity.md
rename to docs/reference/deployment-model.md
diff --git a/docs/intermediate-ca-hierarchy.md b/docs/reference/intermediate-ca-hierarchy.md
similarity index 100%
rename from docs/intermediate-ca-hierarchy.md
rename to docs/reference/intermediate-ca-hierarchy.md
diff --git a/docs/mcp.md b/docs/reference/mcp.md
similarity index 100%
rename from docs/mcp.md
rename to docs/reference/mcp.md
diff --git a/docs/acme-server-threat-model.md b/docs/reference/protocols/acme-server-threat-model.md
similarity index 100%
rename from docs/acme-server-threat-model.md
rename to docs/reference/protocols/acme-server-threat-model.md
diff --git a/docs/acme-server.md b/docs/reference/protocols/acme-server.md
similarity index 100%
rename from docs/acme-server.md
rename to docs/reference/protocols/acme-server.md
diff --git a/docs/async-polling.md b/docs/reference/protocols/async-ca-polling.md
similarity index 100%
rename from docs/async-polling.md
rename to docs/reference/protocols/async-ca-polling.md
diff --git a/docs/crl-ocsp.md b/docs/reference/protocols/crl-ocsp.md
similarity index 100%
rename from docs/crl-ocsp.md
rename to docs/reference/protocols/crl-ocsp.md
diff --git a/docs/est.md b/docs/reference/protocols/est.md
similarity index 100%
rename from docs/est.md
rename to docs/reference/protocols/est.md
diff --git a/docs/scep-intune.md b/docs/reference/protocols/scep-intune.md
similarity index 100%
rename from docs/scep-intune.md
rename to docs/reference/protocols/scep-intune.md
diff --git a/docs/deployment-vendor-matrix.md b/docs/reference/vendor-matrix.md
similarity index 100%
rename from docs/deployment-vendor-matrix.md
rename to docs/reference/vendor-matrix.md