Brad Balderson

60%
Flag icon
This is the essence of abstraction (finding a simple way to think about a complex entity), and it’s also what you must do when writing higher-level comments. A good higher-level comment expresses one or a few simple ideas that provide a conceptual framework,
Brad Balderson
In other words, your higher level comments should explain the image you held within your mind when writing the code in order to recreate that image in the mind of the person attempting to understand it; thus granting the capacity for the person to look at the code with the eyes of the person who created it.
A Philosophy of Software Design
Rate this book
Clear rating