Colophon
The Pipes is a static site built with Astro and Starlight, the same stack as Book 1, The Glue. Chapters are MDX. Every diagram is hand-authored inline SVG styled only through CSS tokens, so it follows light and dark mode and prints cleanly. Search is Pagefind, built at compile time. There are no web fonts (zero font requests) and no client framework: the seven interactive demos are small custom elements that start only when you scroll near them, and each has a plain-text fallback.
It’s hosted on Cloudflare Pages. Hashed assets under /_astro/ are cached for a year as immutable; HTML is revalidated on every request; security headers (X-Content-Type-Options, Referrer-Policy, HSTS, a frame-ancestors CSP) are set in _headers. In other words, the book tries to be good by its own lessons.
The diagram language
Section titled “The diagram language”The city metaphor has a visual vocabulary: buildings with roofs for hosts, numbered doors for ports, blue guards for firewalls, a teal receptionist’s desk for the reverse proxy, a directory book for DNS, purple tunnels for anything encrypted. Colour means trust: amber is the open internet, green is your private network, purple is encrypted, red is blocked or broken, blue is policy, teal is “look here”.
How it was written
Section titled “How it was written”The book was written from a detailed brief in one sitting, by an AI coordinator and a team of parallel AI writers, each owning one chapter and working from a shared voice guide, diagram style guide and running-lab spec. No web lookups were used, by design. Mechanisms are stated with care; where a date, figure or incident detail was uncertain, the text says so (“roughly”, “as of the mid-2020s”, “a widely told story”) or labels the story as a composite. Provider details (prices, free tiers, limits, image defaults) change often: check the provider’s current documentation before relying on any specific number.
No verification loops were run (no link checker, Lighthouse CI or snippet testing); the site was built and deployed. Commands in lab hints and appendices are illustrative and assume Ubuntu 24.04 on a throwaway lab VPS, never a production server.
Conventions
Section titled “Conventions”- Example addresses come from documentation ranges (
192.0.2.0/24,198.51.100.0/24,203.0.113.0/24,2001:db8::/32). The lab server is always203.0.113.10. pipeslab.instands in for whatever cheap domain you use for the lab.- The diagnostic mantra is always written the same way: Name → Address → Route → Door → Guard → Receptionist → App.
- Port-scanning exercises target only your own lab VPS or
scanme.nmap.org.
Book 2 of a series. Book 1: The Glue.