Vernünftigerweise ist es in unserem Unternehmen Pflicht, jede einzelne Funktion mit erklärendem Kommentar zu dokumentieren, was diese Funktion tut.
Heute war mein Kollege gerade dabei, einige Code-Stellen nachzukommentieren die wir gemeinsam in den letzten Tagen geschrieben hatten.
Dabei machte er eine angenehme Entdeckung:
Du weißt, dass dein Code gut lesbar ist, wenn es Dir schon ganz peinlich ist, ihn noch dokumentieren zu müssen.