Clear Is Better Than Clever

I read a PDF from Dave Cheney today titled Clear Is Better Than Clever. I really liked it, so I took some notes. Without further ado:

Software engineering is what happens to programming when you add time and other programmers. – Russ Cox

We need to read each other’s code because we have to work together. We need to read and understand each other’s work, so that we can maintain it and improve it over time. This is the distinction between “software programming” and “software engineering”.

Code is not literature. We don’t read code, we decode it. – Peter Seibel

We call it source code, not source literature.

Rule Time!

Guiding Principles

If software cannot be maintained, it will be rewritten.

Written on 06 May 2019