Wenn ein Teil des Quelltextes nicht offensichtlich ist, d.h. seine Struktur und Richtigkeit hängt von Informationen ab, die sich einem Leser nicht sofort erschließen, sollten diese Informationen auf jeden Fall dokumentiert werden. Ein guter Indikator für eine solche Situation ist ein Fehler. Wenn man eine subtile Eigenschaft des Programmes bei der Fehlerbehebung entdeckt, dann sollte diese Eigenschaft mit einem Kommentar versehen werden, welcher das Problem und dessen Lösung beschreibt. Natürlich wäre es besser, wenn man den Fehler auf eine Weise beheben kann, die das subtile Verhalten beseitigt, aber dies ist nicht immer möglich.