jenswinter.com
Software Development 24/7

Eric Wise: Self documenting Code

November 6, 2005 21:20 by Jens

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:

  1. If it looks like a cow and acts like a cow, call it a cow.
  2. 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.


Related posts