Osservate questi esempi.
Docblock solo per la classe:
/**
* Tool to format a text.
*/
class Formatter {
function format() {}
}
Docblock solo per il metodo:
class Formatter {
/**
* Format a text.
*/
function format() {}
}
Docblocks per entrambi (leggermente diversificati):
/**
* Tool to format a text.
*/
class Formatter {
/**
* Format a text.
*/
function format() {}
}
Docblocks identici per entrambi (però creano un po' di rindondanza per i miei gusti):
/**
* Format a text.
*/
class Formatter {
/**
* Format a text.
*/
function format() {}
}
Voi di solito che
modello usate per commentare le vostre classi?