Code wird öfter gelesen als geschrieben

Code schreibst du einmal.
Gelesen wird er hundertmal.

Also schreib für das Lesen.

Der clevere Einzeiler
fühlt sich gut an beim Tippen.
Er kostet jeden Leser
eine Minute Entwirren.

Die ausführliche, langweilige Variante
ist mühsam zu schreiben
und sofort verständlich.

Du bist nicht das Publikum.
Das Publikum ist ein müder Mensch,
der das um 16 Uhr überfliegt
und eigentlich etwas anderes reparieren will.

Schreib für ihn.
Kurze Funktionen. Klare Namen.
Der offensichtliche Weg, offensichtlich.

Cleverness dient dem Autor.
Klarheit dient allen danach.

Das beste Lob für deinen Code
ist nicht „wie hast du das gemacht".
Es ist „ah, ich sehe genau, was das tut".

– Serguey Asael Shinder