dokumentowanie kodu PHP, jakies zalecenia, sugeste, rady? Opcje

[squid]

Coraz czesciej pracuje sie w grupach czesto zmieniaja sie sklay istnieje potrzeba dokumentowania kodu chocby w sposob podstawowy, slyszalem o PEAR::PHPdoc wzorowany na podobnym narzedziu Javy, czy istnieja jakies inne techniki dokumentacji kodu w sposob mniej lub bardziej automatyczny? Jesli ktos uzywalPHPdoc'a to moze podzieli sie spostrzezeniami i uwagami na emat tego narzedzi. bede bardzo wdzieczny ,mysle ze nie tylko mi sie przyda.

Jest jeszcze jedno co mnie trapi odnoscnie PHPdoc's mianowicie jest to narzedzie, ktore powastalo w czasach PHP4 czy w takim razie umozliwaia dokumentacji interfejsow i klas abstrakcyjnych w PHP5??

[DeyV]

Aby ułatwić sobie naukę pisania komentarzy, warto zaopatrzyć się (przynajmniej na te kilkadziesiąt darmowych dni) w edytor Zend 4.0
Program ten świetnie wspiera programistę w pisaniu komentarzy, pokazuje również prawdziwą wartość tych komentarzy, "na żywo" wykorzystując je i podpowiadając programiście.
Co więcej - ma zintegrowanego phpDocumentor'a, pozwalając przy pomocy paru kliknieć wygenerować dokumentację.
I choć ja, podobnie jak hwao, żadko przeglądam wygenerowaną w ten sposób dokumentację, to jednak kod bez tego typu komentarzy jest w tej chwili dla mnie zupełnie nieczytelny.

Tak więc - http://www.phpdoc.org/ i nic więcej nie jest potrzebne (IMG:http://forum.php.pl/style_emoticons/default/winksmiley.jpg) (szczególnie jak sie zapozna z listą dostępnych znacznikówi i ich znaczeń)