An dieser Stelle bringen wir einige allgemeine Hinweise, die das Schreiben von guten Programmen ermöglichen können. Alle Hinweise sind praxiserprobt und bewährt.
Um ein Programm warten zu können, muß es klar strukturiert und lesbar sein. Die klare Struktur im Großen erreicht man durch Gliederung des Programms und Zerlegung in kleinere Module (Unterprogramme, Prozeduren). Diese Module lösen genau umrissene, beschränkte Aufgaben und besitzen klar definierte Schnittstellen: möglichst nur einen Eingang, einen Ausgang, notwendige Übergabeparameter (Eingabe-, Ausgabeparameter). Für die Größe eines Moduls läßt sich kein fester Wert angeben, da sie stark von der zu lösenden Aufgabe beeinflußt wird. Als Faustregel kann ein Umfang bis maximal zwei Seiten Quelltext-Listing (Programmcode) dienen.
Auch die einzelnen Module sollten in sich strukturiert sein. Damit ist einerseits die Struktur im Programmablauf gemeint, andererseits der formale Aufbau des Moduls. Die klare Ablaufstruktur erreicht man durch fleißiges Verwenden von Konstrukten zur strukturierten Programmierung: also kein wildes Springen im Programm, möglichst Ablauf von oben nach unten. Der formale Aufbau sollte für alle Module einheitlich sein. Die wichtigen Stichworte hierbei sind Lesbarkeit und Selbst-Dokumentation. Ein sich selbst dokumentierendes Unterprogramm beginnt mit einem Programmkopf, der aus einem Kommentarteil und einem Vereinbarungsteil besteht, dann folgt der eigentliche Prozedurrumpf. Der Kommentarteil umfaßt die Punkte
Der Vereinbarungsteil beinhaltet Definitionen und Vereinbarungen für die verwendeten Größen sowie Initialisierungen (z.B. Nullsetzen von Variablen).
Der Prozedurrumpf beinhaltet das eigentliche Unterprogramm, er besteht aus den Programmanweisungen. Hierfür sollten die folgenden Punkte beachtet werden.
Die bisher gegebenen Hinweise zum Programmierstil sind nahezu unabhängig von der verwendeten Programmiersprache.