Categorie
PHP

Scrivere commenti in stile PHPDoc

No v’è dubbio che scrivere una buona documentazione è essenziale per il successo di qualsiasi progetto software.
PHPDocumentor è progettato per rendere più facile la creazione della documentazione.
Esso è basato sul sistema Javadoc di Sun, che è un metodo semplice per commentare tutte le funzioni, gli argomenti, variabili e classi in modo che gli sviluppatori possono facilmente riutilizzarli.
Trovare delle regole quando commentiamo e documentiamo il nostro codice è sicuramente un vantaggio,
ispirarsi a PHPDoc consiste nell’inserimento di un blocco di commenti prima di ogni definizione di classe, funzione, o variabile.