Golo Roden hat am 3. März 2020 fünf Regeln für lesbaren Code beschrieben. Sein Maßstab ist die Nachvollziehbarkeit: Andere Entwickler und auch der ursprüngliche Autor sollen später verstehen können, was ein Programm tut und weshalb es so aufgebaut ist.
Roden empfiehlt erstens eine verbindliche Formatierung mit Linter oder automatischem Formatierer. Zweitens sollen Namen die fachliche Aufgabe ausdrücken, statt nur allgemeine technische Rollen zu benennen. Drittens sollte eine Funktion nicht ständig zwischen groben Ablaufschritten und Implementierungsdetails wechseln.
Viertens spricht er sich gegen komplizierte Sprachkonstrukte aus, die nur der Kürze dienen. Fünftens sollen Kommentare Entscheidungen und Abwägungen erklären, statt lediglich den sichtbaren Ablauf zu wiederholen. Die Empfehlungen versteht Roden als Ausgangspunkt, nicht als ausnahmslose Vorschrift.
Lesbarer Code im Spieleprojekt
Auf Spielecode übertragen lässt sich daraus eine konkrete Prüffrage ableiten: Beschreibt eine Funktion eine Spielregel oder versteckt sie mehrere Aufgaben hinter einem unbestimmten Namen? Als eigenes Beispiel wäre awardQuestExperience aussagekräftiger als handleData, sofern tatsächlich Erfahrung für eine abgeschlossene Aufgabe vergeben wird. Ein passender Name ersetzt allerdings keine Prüfung der Implementierung.
Die C++ Core Guidelines zu präzisen Schnittstellen ergänzen diesen Blick: Benennung und erkennbare Verträge gehören zusammen. Ein fachlicher Name hilft wenig, wenn Parameter oder Seiteneffekte unklar bleiben.
Editoransicht und fachliche Bedeutung unterscheiden
Werkzeuge können die Orientierung unterstützen. Visual Studio Code dokumentiert in den Release Notes zu Version 1.42 eine farbliche Hervorhebung eingeklappter Codebereiche. Das offizielle Screenshot-Beispiel zeigt diese Darstellung. Daraus folgt aber keine automatische Prüfung, ob Bezeichner und Programmstruktur fachlich verständlich sind.