3 ms·
The article hints at it, but your sense of the readability of a codebase changes the longer you are exposed to it. Patterns that make it easier to become modera
by bluesnowmonkey 9y ago
The article hints at it, but your sense of the readability of a codebase changes the longer you are exposed to it. Patterns that make it easier to become moderately competent in a particular codebase can actually make it harder to become expert. So if you want to maximize readability, you need to estimate how long future maintainers will live with your code.
Will they drop in and do a single commit and never look at it again? Then make sure everything you need to understand a piece of code is right there next to it.
Will they work on it for a long time, changing many parts? Then be very consistent with the patterns and idioms you use across the project, so that their previous experience changing other parts of it helps them understand how to make the next change.