DEV Community

Ka Wai Cheung
Ka Wai Cheung

Posted on

Naming Things: Thoughts on one of coding’s most elusive tasks

Hey Devs!

I've just released a free online book called Naming Things. It's a collection of experiences I've had with naming all kinds of things in code--classes, objects, methods, properties, and business concepts.

I've had the unique opportunity to work mainly on one piece of software for many years--I began developing DoneDone in 2008 and I've been deeply involved in its maturation for more than a decade.

DoneDone's codebase is something I look at nearly every day. To care for the same product for so long, it helps to actually love what you're working on. Naming things well is especially important to me because of this.

As Phil Karlton famously wrote:

There are only two hard things in Computer Science: cache invalidation and naming things.

In this book, I hope to show you a few of the surprising conundrums I've faced with naming and how I ultimately resolved (or did my best to resolve) them. This book is an honest and open discussion about a topic I think is underdiscussed in our industry. I do hope you enjoy it.

Top comments (4)

Collapse
 
patricktingen profile image
Patrick Tingen • Edited

Hi, Just read the first part, definitely going to read the rest, thumbs up!

O, and by the way, I knew the quote as follows:

There are only two hard things in Computer Science: cache invalidation, naming things and off-by-1 errors

Collapse
 
developerscode profile image
Ka Wai Cheung

Thanks!

Yep, there are many great variations of the Karlton quote :)

Collapse
 
daxtersky profile image
Miko

Hey there! The book looks very interesting. Is it possible to have it ebook format? Keep up the good work!

Collapse
 
developerscode profile image
Ka Wai Cheung

Definitely will consider this in the future. Thanks!