Software Engineering
Writing Engineering Docs People Actually Read
Docs organized around questions instead of topics, with explicit freshness and ownership, are the ones that stay accurate and get reused.
3 min read
Tag
4 articles
Docs organized around questions instead of topics, with explicit freshness and ownership, are the ones that stay accurate and get reused.
Technical debt taken on deliberately with a repayment plan gets paid back; debt that accumulates silently almost never does.
WhatsApp famously ran hundreds of millions of users on a strikingly small engineering team by designing operational simplicity into the system itself.
Why code review that works at five engineers breaks at fifty, and the concrete conventions that keep review fast and fair as teams grow.