Ich habe ein, mir neues Feature in phpDoc gefunden um Tutorials direkt in den generierten Code einzubinden.
Alles was man dafür tun muss ist in ein xml Dokument im docBook Format zu schreiben und dieses in ein bestimmtes Verzeichnis zu legen. PhpDoc findet darauf hin die Files automatisch und generiert das Tutorial zusammen mit der restlichen API Doc.
Das ebenso generierte Tutorial findet ihr hier hier