3 ms·
if it takes more than 5 minutes for the other programmer to have a high level idea of the design, assume that the code is not readable. I'd argue that a high-l
by bodhi 17y ago
if it takes more than 5 minutes for the other programmer to have a high level idea of the design, assume that the code is not readable.
I'd argue that a high-level description of the system being easy to grasp is kind-of orthogonal to whether the code is readable or not.
- ricree 17y agoPerhaps, but I'm guessing that what he means here is more of a rough structural understanding of the code. In other words, what pieces have what function, and in general how do they interact with one another. While this doesn't necessarily mean the code will be readable, I'd say that there's a lot to be said for a code layout in which it's easy to figure out roughly which code needs to be touched to make a given change or fix.