diff --git a/docs/connector-apache.md b/docs/reference/connectors/apache.md
similarity index 92%
rename from docs/connector-apache.md
rename to docs/reference/connectors/apache.md
index 2181fcf..563fab0 100644
--- a/docs/connector-apache.md
+++ b/docs/reference/connectors/apache.md
@@ -1,6 +1,11 @@
 # Apache httpd Connector — Operator Deep-Dive
 
-> Per Phase 14 of the deploy-hardening II master bundle.
+> Last reviewed: 2026-05-05
+>
+> Per Phase 14 of the deploy-hardening II master bundle. For the
+> connector-development context (interface contract, registry, atomic
+> deploy primitive shared across all targets), see the
+> [connector index](index.md).
 
 ## Overview
 
diff --git a/docs/connector-f5.md b/docs/reference/connectors/f5.md
similarity index 95%
rename from docs/connector-f5.md
rename to docs/reference/connectors/f5.md
index 1de9c35..dd2b60c 100644
--- a/docs/connector-f5.md
+++ b/docs/reference/connectors/f5.md
@@ -1,6 +1,11 @@
 # F5 BIG-IP Connector — Operator Deep-Dive
 
-> Per Phase 14 of the deploy-hardening II master bundle.
+> Last reviewed: 2026-05-05
+>
+> Per Phase 14 of the deploy-hardening II master bundle. For the
+> connector-development context (interface contract, registry, atomic
+> deploy primitive shared across all targets), see the
+> [connector index](index.md).
 
 ## Overview
 
diff --git a/docs/connector-iis.md b/docs/reference/connectors/iis.md
similarity index 96%
rename from docs/connector-iis.md
rename to docs/reference/connectors/iis.md
index b8726b4..09b4d5f 100644
--- a/docs/connector-iis.md
+++ b/docs/reference/connectors/iis.md
@@ -1,6 +1,11 @@
 # Microsoft IIS Connector — Operator Deep-Dive
 
-> Per Phase 14 of the deploy-hardening II master bundle.
+> Last reviewed: 2026-05-05
+>
+> Per Phase 14 of the deploy-hardening II master bundle. For the
+> connector-development context (interface contract, registry, atomic
+> deploy primitive shared across all targets), see the
+> [connector index](index.md).
 
 ## Overview
 
diff --git a/docs/connectors.md b/docs/reference/connectors/index.md
similarity index 99%
rename from docs/connectors.md
rename to docs/reference/connectors/index.md
index 0d90e6c..1701ae4 100644
--- a/docs/connectors.md
+++ b/docs/reference/connectors/index.md
@@ -1,7 +1,24 @@
 # Connector Development Guide
 
+> Last reviewed: 2026-05-05
+>
+> This is the canonical connector reference. Per-connector deep-dive
+> pages exist for the targets that have unique operational quirks
+> (apache, f5, iis, k8s, nginx — see siblings in this directory). Other
+> connectors are documented inline in this file and will be extracted
+> to their own pages as operational depth grows. Cross-link from this
+> index to per-connector pages where they exist.
+
 Connectors extend certctl to integrate with external systems for certificate issuance, deployment, and notifications. This guide covers the connector interfaces, built-in implementations, and how to build your own.
 
+**Per-connector deep-dive pages** (siblings in this directory):
+
+- [Apache](apache.md) — Apache httpd connector deep dive
+- [F5 BIG-IP](f5.md) — F5 connector deep dive (proxy agent + iControl REST)
+- [IIS](iis.md) — Microsoft IIS connector deep dive (local PowerShell + WinRM modes)
+- [Kubernetes Secrets](k8s.md) — k8s.io/tls Secrets connector deep dive
+- [NGINX](nginx.md) — NGINX connector deep dive (deploy contract + quirks)
+
 ## Contents
 
 1. [Overview](#overview)
diff --git a/docs/connector-k8s.md b/docs/reference/connectors/k8s.md
similarity index 93%
rename from docs/connector-k8s.md
rename to docs/reference/connectors/k8s.md
index 7550125..4101546 100644
--- a/docs/connector-k8s.md
+++ b/docs/reference/connectors/k8s.md
@@ -1,6 +1,11 @@
 # Kubernetes Secrets Connector — Operator Deep-Dive
 
-> Per Phase 14 of the deploy-hardening II master bundle.
+> Last reviewed: 2026-05-05
+>
+> Per Phase 14 of the deploy-hardening II master bundle. For the
+> connector-development context (interface contract, registry, atomic
+> deploy primitive shared across all targets), see the
+> [connector index](index.md).
 
 ## Overview
 
diff --git a/docs/connector-nginx.md b/docs/reference/connectors/nginx.md
similarity index 96%
rename from docs/connector-nginx.md
rename to docs/reference/connectors/nginx.md
index cfd21a6..457218f 100644
--- a/docs/connector-nginx.md
+++ b/docs/reference/connectors/nginx.md
@@ -1,7 +1,12 @@
 # NGINX Connector — Operator Deep-Dive
 
-> Per Phase 14 of the deploy-hardening II master bundle. Operator-
-> grade documentation for the NGINX target connector.
+> Last reviewed: 2026-05-05
+>
+> Per Phase 14 of the deploy-hardening II master bundle. Operator-grade
+> documentation for the NGINX target connector. For the
+> connector-development context (interface contract, registry, atomic
+> deploy primitive shared across all targets), see the
+> [connector index](index.md).
 
 ## Overview