Deprecated: Assigning the return value of new by reference is deprecated in /srv/www/vhosts/blog.tviel.de/wp-settings.php on line 520 Deprecated: Assigning the return value of new by reference is deprecated in /srv/www/vhosts/blog.tviel.de/wp-settings.php on line 535 Deprecated: Assigning the return value of new by reference is deprecated in /srv/www/vhosts/blog.tviel.de/wp-settings.php on line 542 Deprecated: Assigning the return value of new by reference is deprecated in /srv/www/vhosts/blog.tviel.de/wp-settings.php on line 578 Deprecated: Function set_magic_quotes_runtime() is deprecated in /srv/www/vhosts/blog.tviel.de/wp-settings.php on line 18 Kommentieren gehört zum guten Ton « Hier bloggt der Eisbär

Kommentieren gehört zum guten Ton

Schon in der Grundschule zur Programmierung predigte der Lehrer: “Kommentare sind sinnvoll, …”. Das man es allerdings auch übertreiben kann, zeigt folgendes Beispiel durchaus deutlich.

http://de.worsethanfailure.com/Articles/Leicht-entflammbare-Kommentare.aspx

Ich werde mir jetzt auch angewöhnen den Bürokrieg seelisch in meinem Quellcode zu verarbeiten.

Funktionsbezeichnungen wie:

  • HopefullyNobodyChecksThisFunction()
  • MyColleagueWillNeverUnderstandWhatThisFunctionWillDo()
  • LastFunctionBeforeVacation()

sagen mir nicht auf Anhieb was diese Funktion macht aber zumindest erinnere ich mich schnell daran, wie ich mich fühlte als ich Sie schrieb.

Weitere Beispiele gerne als Kommentar ;-)

Leave a Reply