On reading other people's code
R. Hadi · Sep 8
If a config file has more than a dozen options, half of them aren't being used. The other half are being used in ways the original author didn't predict.
I trust monorepos more in the second year than I did in the first. Most of the early friction goes away once the tooling catches up.
I keep a small log of decisions in a text file. Not architectural — just small ones. "Picked X over Y because Z." Future me reads it more than I thought he would.
The team I learned the most from didn't have great tools. They had a great habit of reading each other's pull requests in full, including the parts that weren't theirs.
Every time I revisit a project after six months, I find at least one place where past-me wrote a comment that present-me has now stopped trusting. Comments rot faster than code.
Caches solve a problem and create three new ones: invalidation, observability, and the slow drift between what the cache thinks is true and what the source thinks is true.
← back to index