Ich habe heute den ganzen Tag damit verbracht meine bislang programmierten Klassen mit PHPDoc-konformen Kommentaren auszustatten und dann eine Dokumentation mit PHPDocumentor zu erstellen. Nach anfänglichen Problemen mit den Kommentaren bin ich jetzt ganz zufrieden mit der erstellten Doku! Siehe hier 🙂
Wenn man sich daran gewöhnt hat, dass (zumindest am Anfang) die Kommentarzeilen im Verhältnis zu den eigentlichen Codezeilen überwiegen, ist diese Form der Dokumentation ganz brauchbar. Vor allem kann man seinem Auftraggeber nachher eine schöne webbasierte Doku übergeben 😉
Dann ist bloß noch die Frage, wie ich die Seiten vernünftig an meine Projektdoku anhängen kann. Die Prüfer wollen das ja sehen… Ich denke, ich werde einfach Auszüge als PDF generieren und als Anhang dahinterhängen.