From b375df767e53760f8facc4d51941acd4d90d8aaf Mon Sep 17 00:00:00 2001 From: shankar0123 Date: Tue, 5 May 2026 02:49:28 +0000 Subject: [PATCH] docs: Phase 2 mechanical file moves to subdirectory structure Pure git mv operations; no content edits. Internal links remain pointing at old paths and will be fixed in Phase 11. Per the Phase 1 audit recommendations at cowork/docs-overhaul-phase-1-audit-2026-05-04/. 35 files moved across 8 audience-organized subdirectories: docs/getting-started/ (5): quickstart.md, concepts.md, examples.md, advanced-demo.md (was demo-advanced.md), why-certctl.md docs/reference/ (6): architecture.md, api.md (was openapi.md), mcp.md, intermediate-ca-hierarchy.md, deployment-model.md (was deployment-atomicity.md), vendor-matrix.md (was deployment-vendor-matrix.md) docs/reference/protocols/ (6): acme-server.md, acme-server-threat-model.md, scep-intune.md, est.md, crl-ocsp.md, async-ca-polling.md (was async-polling.md) docs/operator/ (4): security.md, tls.md, database-tls.md, approval-workflow.md docs/operator/runbooks/ (3): cloud-targets.md (was runbook-cloud-targets.md), expiry-alerts.md (was runbook-expiry-alerts.md), disaster-recovery.md docs/migration/ (3): from-certbot.md (was migrate-from-certbot.md), from-acmesh.md (was migrate-from-acmesh.md), cert-manager-coexistence.md (was certctl-for-cert-manager-users.md) docs/compliance/ (4): index.md (was compliance.md), soc2.md (was compliance-soc2.md), pci-dss.md (was compliance-pci-dss.md), nist-sp-800-57.md (was compliance-nist.md) docs/contributor/ (4): testing-strategy.md, test-environment.md (was test-env.md), ci-pipeline.md, qa-test-suite.md (was qa-test-guide.md) Deferred to later Phase 2 sub-phases: - connectors.md split (Phase 4): docs/connectors.md + docs/connector-{apache,f5,iis,k8s,nginx}.md still at top level - testing-guide.md prune (Phase 5): docs/testing-guide.md still at top level - features.md disperse (Phase 6): docs/features.md still at top level - legacy-est-scep.md split (Phase 7): docs/legacy-est-scep.md still at top level - ACME walkthrough re-homing (Phase 8): three docs/acme-*-walkthrough.md still at top level - Upgrade docs archive (Phase 3): two docs/upgrade-*.md still at top level Cross-reference updates (Phase 11) will happen after all moves and content edits land. Internal links to docs/* paths are temporarily broken until that phase completes. --- docs/{compliance.md => compliance/index.md} | 0 docs/{compliance-nist.md => compliance/nist-sp-800-57.md} | 0 docs/{compliance-pci-dss.md => compliance/pci-dss.md} | 0 docs/{compliance-soc2.md => compliance/soc2.md} | 0 docs/{ => contributor}/ci-pipeline.md | 0 docs/{qa-test-guide.md => contributor/qa-test-suite.md} | 0 docs/{test-env.md => contributor/test-environment.md} | 0 docs/{ => contributor}/testing-strategy.md | 0 docs/{demo-advanced.md => getting-started/advanced-demo.md} | 0 docs/{ => getting-started}/concepts.md | 0 docs/{ => getting-started}/examples.md | 0 docs/{ => getting-started}/quickstart.md | 0 docs/{ => getting-started}/why-certctl.md | 0 .../cert-manager-coexistence.md} | 0 docs/{migrate-from-acmesh.md => migration/from-acmesh.md} | 0 docs/{migrate-from-certbot.md => migration/from-certbot.md} | 0 docs/{ => operator}/approval-workflow.md | 0 docs/{ => operator}/database-tls.md | 0 .../runbooks/cloud-targets.md} | 0 docs/{ => operator/runbooks}/disaster-recovery.md | 0 .../runbooks/expiry-alerts.md} | 0 docs/{ => operator}/security.md | 0 docs/{ => operator}/tls.md | 0 docs/{openapi.md => reference/api.md} | 0 docs/{ => reference}/architecture.md | 0 docs/{deployment-atomicity.md => reference/deployment-model.md} | 0 docs/{ => reference}/intermediate-ca-hierarchy.md | 0 docs/{ => reference}/mcp.md | 0 docs/{ => reference/protocols}/acme-server-threat-model.md | 0 docs/{ => reference/protocols}/acme-server.md | 0 .../{async-polling.md => reference/protocols/async-ca-polling.md} | 0 docs/{ => reference/protocols}/crl-ocsp.md | 0 docs/{ => reference/protocols}/est.md | 0 docs/{ => reference/protocols}/scep-intune.md | 0 docs/{deployment-vendor-matrix.md => reference/vendor-matrix.md} | 0 35 files changed, 0 insertions(+), 0 deletions(-) rename docs/{compliance.md => compliance/index.md} (100%) rename docs/{compliance-nist.md => compliance/nist-sp-800-57.md} (100%) rename docs/{compliance-pci-dss.md => compliance/pci-dss.md} (100%) rename docs/{compliance-soc2.md => compliance/soc2.md} (100%) rename docs/{ => contributor}/ci-pipeline.md (100%) rename docs/{qa-test-guide.md => contributor/qa-test-suite.md} (100%) rename docs/{test-env.md => contributor/test-environment.md} (100%) rename docs/{ => contributor}/testing-strategy.md (100%) rename docs/{demo-advanced.md => getting-started/advanced-demo.md} (100%) rename docs/{ => getting-started}/concepts.md (100%) rename docs/{ => getting-started}/examples.md (100%) rename docs/{ => getting-started}/quickstart.md (100%) rename docs/{ => getting-started}/why-certctl.md (100%) rename docs/{certctl-for-cert-manager-users.md => migration/cert-manager-coexistence.md} (100%) rename docs/{migrate-from-acmesh.md => migration/from-acmesh.md} (100%) rename docs/{migrate-from-certbot.md => migration/from-certbot.md} (100%) rename docs/{ => operator}/approval-workflow.md (100%) rename docs/{ => operator}/database-tls.md (100%) rename docs/{runbook-cloud-targets.md => operator/runbooks/cloud-targets.md} (100%) rename docs/{ => operator/runbooks}/disaster-recovery.md (100%) rename docs/{runbook-expiry-alerts.md => operator/runbooks/expiry-alerts.md} (100%) rename docs/{ => operator}/security.md (100%) rename docs/{ => operator}/tls.md (100%) rename docs/{openapi.md => reference/api.md} (100%) rename docs/{ => reference}/architecture.md (100%) rename docs/{deployment-atomicity.md => reference/deployment-model.md} (100%) rename docs/{ => reference}/intermediate-ca-hierarchy.md (100%) rename docs/{ => reference}/mcp.md (100%) rename docs/{ => reference/protocols}/acme-server-threat-model.md (100%) rename docs/{ => reference/protocols}/acme-server.md (100%) rename docs/{async-polling.md => reference/protocols/async-ca-polling.md} (100%) rename docs/{ => reference/protocols}/crl-ocsp.md (100%) rename docs/{ => reference/protocols}/est.md (100%) rename docs/{ => reference/protocols}/scep-intune.md (100%) rename docs/{deployment-vendor-matrix.md => reference/vendor-matrix.md} (100%) 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