Vlad's Roam Garden

Powered by 🌱Roam Garden

employ the power of natural language to improve readability

Humans are adept at parsing natural language so it's a good thing to strive to utilize that for writing code.

I feel a bit hesitant to assert that we should strive to match natural language fully, as there is power in succinctness and abstraction

Examples

Kotest and Hamcrest with their custom matchers is a great example of applying this principle to testing.

Spec style testing/BDD in general seems like a good application of this.

How do you balance succinctness and readability?

You want your prose to be terse in this context.

Succinctness is good when it is accomplished by rising level of abstraction/syntax

It is not so great when accomplished by omitting details in a way that makes code less comprehensible?