Well-Factored
Notes on writing code that lasts. This blog is for working software engineers who care about the craft: best practices, refactoring techniques, and the engineering judgment behind them, not just the rules but when and why they apply.
Every post goes one level deeper than the textbook version: real-world failure modes, honest trade-offs, and systematic playbooks you can use on the codebase you actually have, not the one in the examples.
Latest posts
- Diff, Merge, Breathe: How to Safely Unify Code Copies That Drifted Apart
A step-by-step field guide to real-world deduplication: find every copy, separate the bugs from the requirements, pin behavior with tests, and merge diverged duplicates without breaking production.
- Copy, Paste, Regret: The Hidden Cost of Repeating Yourself in Code
Why duplicated code is a ticking time bomb: what DRY actually means, how "identical" copies quietly diverge into different behavior, and the one caveat that keeps DRY from becoming its own disaster.
Browse the full archive on the blog page, or subscribe via RSS.