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??

[hwao]

btw. miałem gdzieś zaczątek artykułu o tym (IMG:http://forum.php.pl/style_emoticons/default/dry.gif)

http://webcity.pl/webcity/artykuly.php/t/48 ?

Co do dokumentowania to dla php nie ma nic lepszego od phpDocumentor i kazdy kod jaki pisze "zaopatruje" w jego znaczniki.

Jednak dlamnie niektore sa poprostu nie przydatne :-) bo widac na 1 rzut oka co i jak.

Co prawda do prawad w pracach grupowych takie cos jest niezbedne bo inaczej totalne "pogubienie" sie wkrada, projekty solo to juz roznie :-) chyba ze chcesz potem kod udostepniac.

Osobiscie nie kozystam z tego co generuje phpDocumentor ale komentarze w kodzie sie przydaja