Plain Lines
339389.com

When to skip the abstraction

Anya P. · Feb 5

I write smaller commits than I used to. The commits are uglier in isolation and much easier to read in sequence.

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.

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.

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.

Most of the trouble I see in production comes from boundary cases someone promised would never happen. The code is fine. The plan is fine. The promise is what ages badly.

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.

← back to index