Guides

Multi-part guides on building and running software


Long-form, multi-part guides. Where an article takes one subject apart, a guide builds one thing from start to finish.

Building a Production REST API in Go

Twenty parts, in six sections, building a booking service in Go from a bound socket to a deployment manifest. Configuration, startup and shutdown, logging and redaction, servers and middleware, the request lifecycle, response formats, outbound clients and retries, connection pools and transactions, health and metrics, one complete feature with its write and read paths, four layers of testing, packaging, and the probes that watch it in production.

Written for someone who can write Go and has not built an HTTP service with it, or who built one and is now being asked to run it in production.