Im Kontext des '
literate programming' (z.B. D.E.Knuth: Tangle & Weave) wäre das eine Möglichkeit, die dann jedoch über einen Link realisiert würde.
Auch die Aussage
wenn du schon ein ganzes Bild brauchst, dann machst du was falsch.
kann man so stehen lassen.
Ich glaube, man wirft hier 'dokumentieren', 'kommentieren' und 'erklären' in einen Topf. Das sollte man nicht.
Zu einem Softwaresystem, das selbstverständlich selbstkommentierend ist (also ohne Kommentare auskommt), gehört natürlich eine Systemdokumentation, das die Verfahren, Quellen und Hintergründe beschreibt. Inklusive Bildchen.