[Php-it] Scrivere documentazione oltre PHPDoc

[Andrea Franceschini]

Il 17/04/07, Domenico L.<domenico.lorusso a pleiade.it> ha scritto:

> > PHPDoc va benissimo per compilare una reference, come dici tu. Ma da
> > una documentazione estesa per lo sviluppatore finale mi attenderei più
> > che un reference, una spiegazione di cosa fa questo o quel metodo, a
> > cosa servono questa o quella proprietà e un minimo di esepio d'uso,
> > specialmente se ci possono essere aspetti poco intuitivi.
> esatto, strumenti consigliati? sempre nell'ottica magari di generare un
> chm o qualcosa di simile...
>
> Insomma una sorta di bbcode per documentazione... :-)

Scusa, mi sono appena reso conto che non ti ho detto la parte
importante -.- Io ti consiglio LaTeX, però a quel livello non
inserisci niente tra i sorgenti, crei un documento esterno. Da LaTeX
puoi produrre PS, PDF, HTML, RTF... :) Per me è la soluzione più
sensata per produrre una documentazione di quel livello.