docs: Reorganize README and architecture documentation - #64

Open

scotwells wants to merge 15 commits into

mainfrom

docs/architecture-reorg

Commits on Jul 24, 2026

docs: Reorganize README and architecture documentation

scotwells
and
claude
committed
docs: Render architecture C4 diagrams with PlantUML + Datum theme

scotwells
and
claude
committed
docs: Add backend architecture, drop activity, apply tech-writing style

scotwells
and
claude
committed
docs: Document PowerDNS propagation timing

scotwells
and
claude
committed
docs: Frame the operator as a component of the DNS service

scotwells
and
claude
committed
docs: Name LightningStream poll intervals in PowerDNS timing

scotwells
and
claude
committed
docs: Show platform context in the DNS system-context diagram

scotwells
and
claude
committed
docs: Fix inaccuracies found by adversarial validation

scotwells
and
claude
committed
docs: Use GitHub callout syntax for the DNSZoneDiscovery note

scotwells
and
claude
committed
docs: Scope the API reference to the user-facing API

scotwells
and
claude
committed
docs: Co-locate diagrams with their docs; drop diagrams index

scotwells
and
claude
committed
docs: Keep PowerDNS specifics out of the generic topology

scotwells
and
claude
committed
docs: Depict a backend-agnostic topology, not the PowerDNS shape

scotwells
and
claude
committed
docs: Lay out wide diagrams left-to-right

scotwells
and
claude
committed
docs: Turn the PowerDNS diagram into a deployment view

scotwells
and
claude
committed