Domanda

Prima di tutto, non sto chiedendo come generare documentazione dalla fonte PHP. È abbastanza facile con librerie come doxygen o phpdocumulor. Quello che sto cercando è un modo per generare automaticamente stock di commenti basati su PHPDOC per classi, metodi, proprietà, ecc. Esistono librerie preesistenti che possono farlo? Ho fatto un po 'di ricerca e non ho trovato nulla.

Lo chiedo solo perché ho un prurito che voglio grattare scrivendo il mio. Tendo a trascorrere ore alla volta a sfornare il codice, salvando la documentazione come ultimo passo (lo so, dovrei davvero farlo mentre vado). Il problema è che, anche se realizzando l'importanza della documentazione in linea, dopo 8 ore consecutive di codifica e scrittura di una dozzina di lezioni con dozzine di metodi e proprietà, è un po 'scoraggiante dover fermarsi e iniziare a scrivere le cose.

Ovviamente, non posso creare automaticamente la documentazione completa. Cose come le descrizioni verbose di classi, proprietà e metodi devono essere tipite a mano. Ma, usando la riflessione, posso facilmente derivare informazioni sufficienti per creare tappeti commenti con segnaposto riempimento.

Se qualcuno può aiutarmi nella ricerca di una soluzione come questa, fantastica. In caso contrario, riuscirò a creare un nuovo repository GitHub e contribuire con qualcosa di utile alla comunità. :)

Nessuna soluzione corretta

Autorizzato sotto: CC-BY-SA insieme a attribuzione
Non affiliato a StackOverflow
scroll top