Code doesn’t have to be a mess

Re:Code doesn’t have to be a mess by mystickphoenix on Monday July 25, 2022 @10:49AM (#32225112)

For me the number one thing I try to focus on is _naming_. If something is hard to name, it's likely hard to understand or overly abstracted (misdirected). If something is easy to name, it likely follows [insert any software development "best practice" here].

What's a good name? I love the phrasing from _Elements of Clojure_ by Zachary Tellman [1]

> Names should be narrow and consistent. A *narrow* name clearly excludes things it cannot represent. A *consistent* name is easily understood by someone familiar with the surrounding code, the problem domain, and the broader [language] ecosystem.

1. https://leanpub.com/elementsofclojure/read_sample

[ Parent | on HN ]

Re:Code doesn’t have to be a mess by bcrosby95 on Monday July 25, 2022 @12:28PM (#32226710)

Yeah, I find that if you can name something well then everything else falls in place much easier.

At work, for any large feature, we usually go over naming pretty extensively, and aim to be consistent in documentation, code, and discussions, so everyone knows exactly what everyone is talking about.

[ Parent | on HN ]