documentation

Engineering Notes · 1 min read · 2026-02-23

Why I Started Saving Packet Captures with the Incident Notes

A short pcap plus context is often more useful six months later than a page of remembered conclusions.

Writing & Ideas · 2 min read · 2023-06-30

Documentation Should Preserve the Path From Claim to Evidence

Writing that a system works is different from documenting how that conclusion was reached. Without evidence, the next person cannot reproduce the claim. Conditions, tests, and limits make the result traceable.

documentation evidence

DevOps & Culture · 1 min read · 2022-07-26

Documentation Is Part of the Runtime

Runbooks and architecture notes reduce recovery time only when they evolve with the system they describe.

documentation runbook operations

Voiceware Engineering · 2 min read · 2021-08-10

What Port 5001 Tells Me—and What It Does Not

Reading infrastructure signal carefully without inventing application internals.

voiceware audio documentation architecture

Production Engineering · 1 min read · 2020-03-28

A Source-Ownership Manifest Solved the 'Who Owns This Container?' Problem

Seeing a service in Portainer does not tell you which repository, runbook or backup path can recreate it.

ownership GitOps inventory documentation