Refactoring To Clarity
There's another point that I use to decide when I'm "done" with refactoring a particular piece of code, which is that I think that other people will be able to clearly see the pattern I've designed and will maintain the code in that pattern from then on.
Sometimes I have to write a little piece of documentation that describes the intended design of the system, so that people will follow it, but in general my theory (and this one really is just a theory – I don't have enough evidence for it yet) is that if I design a piece of code well enough, it shouldn't need a piece of documentation describing how it's supposed to be designed. It should probably be visible just from reading the code how it's designed, and it should be ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access