Lightning Bug and Lightning

- - posted in documentation, learning, naming, programming, teaching

Mark Twain famously said, “The difference between the almost right word & the right word is really a large matter–it’s the difference between the lightning bug and the lightning.”

When it comes to naming variables, objects, functions, classes, and namespaces, the same applies.

Clarity and expressiveness come with experience. However, the beginner can still learn a lot by looking at conventions, best practices, reading code from peers, and thinking hard about a word that best express the programmer’s intent.