Hja hja ...
Nah jaz komendatrjev skoraj ne pišem, kodo pregledno ... komentarje pa zelo redko ...
Sicer pa zadeva ni tako neberljiva če spremenljivke, funkcije ... pametno poimenuješ ...
Komentarji so itak namenjeni samemu programerju. Meni osebno je bolj pomembno da ne pozabim dokumentirat vsak class, metodo, spremenljivko ... z DocBlock sintakso, da lahko potem s pomocjo phpDocumentorjem generiram API.
Vsakemu zacetniku se zdi to odvec, ampak ko se navadis, gre kar hitro. Nekateri IDE-ji pa so ze tako pamenti, da ti nad funkcijo sami zgenerirajo ustrezno sintakso za opis vhodnih, izhodinih parametrov.
Ce ne bi tega pisal bi si lahko cez 2 tedna, vse lase populil (ki ji itak nimam), preden bi ugotovil kaksnega tipa so vhodni parametri in kaj metoda vraca.
public function inheritsRole($role, $inherit, $onlyParents = false)
{
return $this->_getRoleRegistry()->inherits($role, $inherit, $onlyParents = false);
}
:)