Wer sich nicht mit php auskennt, wird wahrscheinlich auch nicht wissen was mit die "Funktion foo macht..." gemeint ist, da er wahrscheinlich nicht weiß was eine Funktion ist. Und wenn man nichts mit php macht nützt mir das Wissen was die Funktion foo macht auch nichts, da ich ja nichts programmiere wo ich das Wissen einsetzen kann. Von daher verstehe ich nicht was du genau willst.
Die Benutzer-Dokumentation unterscheidet sich stark von der Klassen Dokumentation. Daran wird man auch so schnell nichts ändern können da ein Benutzer das System nutzen will und es
nicht programmieren will.
Wie gesagt beim phpDocComment kann man sich auch
Html-Datei mit der Dokumentation generieren lassen.
LG Björn