Code should read like poetry

June 26, 2021
Code should have certain patterns and rythms that make it easy to read and understand.

Good code should be easy for people to read. As Martin Fowler says: “Any fool can write code that a computer can understand. Good programmers write code that humans can understand.”

How do you know if humans can understand your code?

A good friend once told me: “Good code should read like poetry.”

I guess poetry itself is subjective, but I like this idea. When you read your code, it should have certain patterns and rythms that make it easy to read and understand.

Short functions, descriptive names, consistent formatting.

Now it almost sounds like I’m describing Haiku…?

Related Content

Is it a good day to optimize?

How do you decide between watching James Bond or a romantic comedy? Every decision optimizes for something. What do you optimize for when designing computing systems?

.sh: The poor man's Infrastructure-as-Code

IaC can be complex, but it doesn't need to be. Start small. Start with the tools you know today.

The proper way to arrange cutlery

How I learned to stop caring about the orderly arrangement of my cutlery rack.