In a Nutshell

In your name I will hope, for your name is good.

Psalms 52:9

Our ancient ancestors knew it, and good programmers know it: It’s crucial to name things well. Good names serve more than just an aesthetic purpose; they convey information about the structure of code. They are an essential tool to aid comprehensibility and maintainability.

The main reason we write code in high-level languages is to communicate, and that communication is to an audience of code readers—other programmers—rather than to the compiler. Bad names have the potential to mislead. There is power in a name, and experienced programmers understand the balance of concerns involved when naming any part of their code.

Get Code Craft 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.