Der wenig kompetente Entwickler

schreibt Kommentar wenigstens vor dem Kopf jeder Funktion

• was macht die Funktion
• wozu werden die einzelnen Parameter benötigt
• welche Parameter werden nur gelesen
• über welche Parameter werden Variablen verändert
• welche globalen Daten werden gelesen
• welche globalen Daten werden verändert

bei komplexen Funktionen wird zusätzlich beschrieben, wie (nach welchem Algorithmus) die Funktion arbeitet und begründet, warum auf diese Art und Weise.

• aussagekräftige, bedeutungsvolle und spezielle Namen
• nicht zwei Namen (Variable) für eine Sache (einen Wert)
• nicht ein Name (eine Variable) für mehrere Sachen (Werte)
• die Länge der Identifikatoren proportional zur Größe des Sichtbarkeitsbereiches des zugehörigen Objekts
• kn bngng ggnbr Vkln
  ein Programm wird häufiger gelesen als geschrieben

verwendet einen konsistenten Einrückstil

• Zuordnung begin, end
• if: else-if parallel, nicht geschachtelt
• Absätze im Programm

verwendet NIEMALS Konstanten im Code

while ( i < 255 ) ....

while ( i < maxBufferSize ) ...

• achtet auf Kleinigkeiten
• verbessert lokal Anweisungen und Schleifen

• schreibt Vorbedingungen vor Kontrollanweisungen (Schleifen, Bedingungen, Blöcke, ...)
• schreibt Nachbedingungen hinter Kontrollanweisungen
• weiß, daß solche Zusicherungen (assertions) wichtige Kommentare sind

schreibt in einem für Menschen lesbaren und verständlichen Stil

• kann große und komplizierte Programme zur Lösung eines Problems schreiben
• erweitert die Funktionalität eines Programms durch Hinzufügen von mehr Programmcode

Wichtige Hinweise für die erfolgreiche Teilnahme an Programmierübungen, Software-Praktika und Projekten.