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
Engineering Practices
7 articles
Software Engineering
Monorepo vs. Polyrepo: The Trade-offs That Actually Matter
Monorepos and polyrepos both work at scale — the real decision is which trade-offs your organization is already equipped to absorb.
3 min read
Software Engineering
Feature Flags Architecture: Beyond the Boolean Toggle
Release flags, experiment flags, and ops flags need different lifecycles — a flag system without a removal process always accumulates debt.
3 min read
Software Engineering
The Testing Pyramid, Revisited
The testing pyramid was always a proxy for a cost trade-off — here's the trade-off itself, and when the pyramid's shape doesn't apply.
2 min read
Software Engineering
Managing Technical Debt Deliberately
Technical debt taken on deliberately with a repayment plan gets paid back; debt that accumulates silently almost never does.
3 min read
Software Engineering
Code Review Culture That Scales Past Ten Engineers
Why code review that works at five engineers breaks at fifty, and the concrete conventions that keep review fast and fair as teams grow.
3 min read
Performance
Profiling Before Optimizing: A Workflow
The fastest way to waste a sprint is optimizing code that was never the bottleneck — a repeatable workflow for measuring before you touch anything.
3 min read