Eric Wise hat einen Blogeintrag über "self documenting code"
geschrieben. Er beschränkt sich darin fast ausschließlich auf die
Namensgebung von Methoden und Variablen. Er hat nennt zwei Faustregeln:
- If it looks like a cow and acts like a cow, call it a cow.
- Once you call it a cow, make sure you always call it a cow.
Dem gibt es eigentlich kaum noch etwas hinzuzufügen.
Ich bin der Meinung, dass sich Quelltext lesen lassen sollte wie ein
Roman - wie ein Groschenroman. Denn langweilig sollte er sein.
Quelltext sollte keine interessanten, spannenden oder trickreichen
Kniffe enthalten. Nur so bleibt er lesbar und leicht verständlich.