Writing

Notes on building systems that have to stay up. Plain language, real sources, and the numbers that go with them.

Written by Rahul Kumar Choudhary. Each piece comes out of a system that had to keep running, and the figures on every card are the ones the article has to defend.

RSS feed

1 article tagged Engineering Practice

  • 8 min readArchitectureTestingEngineering Practice

    Docs are a wish. Review does not scale. So the rules run.

    Architectural decisions die two ways: people leave, and people tidy up. Documentation survives neither. So I stopped writing the decisions down and started writing them as tests that fail. There are 855 of them, including one that caught a screen describing a connection flow that a good share of the services it connects to do not use.

One long piece, when there is one worth sending

Agents and distributed systems, argued from a codebase rather than from opinion. It goes out when a piece is finished and not on a schedule, so it will not fill your inbox.

Free. Unsubscribe whenever. Hosted on Substack.

Writing — Engineering Practice articles — Rahul Kumar Choudhary