Explaining Software Design

Subscribe
Archives
  Back to the email
Zach Tellman
Sep. 25, 2024, evening

When you choose a name, you should have some expectations for what the reader already has in their head (I call this the "prefix" here). For instance, I think it's fair to expect that someone reading a method is passingly familiar with the surrounding class. Even if they're not, naming choices that build upon the class will force them to double back and understand it.

I believe this is much simpler (in the information theoretic sense) than trying to reexplain the class at every level. I'll be expanding on this in the next post.

Reply Report
This email brought to you by Buttondown, the easiest way to start and grow your newsletter.