docs: Phase 4 (structural) — move connectors.md + 5 deep dives into reference/connectors/

Per Phase 1 audit at cowork/docs-overhaul-phase-1-audit-2026-05-04/.
Phase 4 in the audit recommended a full split of connectors.md (2055
lines) into an index + 27 per-connector pages (12 issuer + 15 target).
This commit lands the structural half of that work; full per-target
page extraction is deferred to follow-up commits.

Renames (all blame-preserving):
  docs/connectors.md         → docs/reference/connectors/index.md
  docs/connector-apache.md   → docs/reference/connectors/apache.md
  docs/connector-f5.md       → docs/reference/connectors/f5.md
  docs/connector-iis.md      → docs/reference/connectors/iis.md
  docs/connector-k8s.md      → docs/reference/connectors/k8s.md
  docs/connector-nginx.md    → docs/reference/connectors/nginx.md

Edits:
  - docs/reference/connectors/index.md gets a top-of-doc note
    explaining the per-connector deep-dive sibling pattern + a forward
    list of the 5 per-target pages.
  - The 5 per-connector deep-dive pages each get a `Last reviewed:
    2026-05-05` header + a back-link to the index.

Deferred to future commits (Phase 4b/c follow-on):
  - Extracting the 12 issuer sections from index.md into per-issuer
    pages at reference/connectors/{acme,awsacmpca,digicert,ejbca,
    entrust,globalsign,googlecas,local,openssl,sectigo,stepca,vault}.md
  - Extracting the 10 remaining target sections from index.md into
    per-target pages at reference/connectors/{caddy,traefik,envoy,
    haproxy,postfix-dovecot,ssh,javakeystore,wincertstore,awsacm,
    azurekv}.md

The pragmatic split makes this Phase 4 work incrementally landable —
each per-connector extraction is a small follow-up commit that doesn't
change the docs/ tree shape further. Cross-references from README.md
and other docs to docs/connectors.md still need fixing in Phase 11.
This commit is contained in:
shankar0123
2026-05-05 03:14:39 +00:00
parent cee008207b
commit 633e440787
6 changed files with 48 additions and 6 deletions
@@ -1,6 +1,11 @@
# Apache httpd Connector — Operator Deep-Dive # 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 ## Overview
@@ -1,6 +1,11 @@
# F5 BIG-IP Connector — Operator Deep-Dive # 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 ## Overview
@@ -1,6 +1,11 @@
# Microsoft IIS Connector — Operator Deep-Dive # 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 ## Overview
@@ -1,7 +1,24 @@
# Connector Development Guide # 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. 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 ## Contents
1. [Overview](#overview) 1. [Overview](#overview)
@@ -1,6 +1,11 @@
# Kubernetes Secrets Connector — Operator Deep-Dive # 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 ## Overview
@@ -1,7 +1,12 @@
# NGINX Connector — Operator Deep-Dive # NGINX Connector — Operator Deep-Dive
> Per Phase 14 of the deploy-hardening II master bundle. Operator- > Last reviewed: 2026-05-05
> grade documentation for the NGINX target connector. >
> 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 ## Overview