Part I. Surface-Level Improvements
We begin our tour of readability with what we consider âsurface-levelâ improvements: picking good names, writing good comments, and formatting your code neatly. These types of changes are easy to apply. You can make them âin place,â without having to refactor your code or change how the program runs. You can also make them incrementally, without a huge time investment.
These topics are very important because they affect every line of code in your codebase. Although each change may seem small, in aggregate they can make a huge improvement to a codebase. If your code has great names, well-written comments, and clean use of whitespace, your code will be much easier to read.
Of course, thereâs a lot more beneath the surface level when it comes to readability (and weâll cover that in later parts of the book). But the material in this part is so widely applicable, for so little effort, that itâs worth covering first.
Get The Art of Readable Code now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.