loading...

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

developerscode profile image Ka Wai Cheung ・1 min read

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.

Discussion

pic
Editor guide
Collapse
patricktingen profile image
Patrick Tingen

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 Author

Thanks!

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

Collapse
daxtersky profile image
Mikołaj

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 Author

Definitely will consider this in the future. Thanks!