Meiner Meinung nach sollte Code auch ohne Doku der verwendeten Module verständlich sein und das bedeutet, er darf keine Missverständnisse provozieren. Denn wenn es mal daran geht, dass ich mein Projekt "bloody alpha" veröffentliche und nach Teammembern suche, bringt mir die Doku erst mal rein gar nichts: Das Programm muss nicht nur zumindest erkennen lassen, wozu es dient, welche Probleme es wie zu lösen versucht, sondern der Code muss sich auch sehen lassen können, zur Mitarbeit einladen (ja, ich kenne perltidy und perlcritic, aber kein perldetectpitfallsindesign). Und dazu gehört für mich auch die Frage, welche Anstrengungen sich lohnen um die Logik zum Traversierung von Baumstrukturen zu verbergen, damit der eigentliche Zweck eines bestimmten Stück Codes idealerweise ohne Umweg ins Auge springt.

-- flowdy