Witaj Gościu! ( Zaloguj | Rejestruj )

Forum PHP.pl

> dokumentowanie kodu PHP, jakies zalecenia, sugeste, rady?
squid
post
Post #1





Grupa: Zarejestrowani
Postów: 358
Pomógł: 0
Dołączył: 3.07.2003
Skąd: Szczecin->niebuszewo->*(next to window)

Ostrzeżenie: (0%)
-----


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??
Go to the top of the page
+Quote Post
 
Start new topic
Odpowiedzi
hwao
post
Post #2


Developer


Grupa: Moderatorzy
Postów: 2 844
Pomógł: 20
Dołączył: 25.11.2003
Skąd: Olkusz




Cytat(bela_666 @ 2005-03-03 11:07:35)
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
Go to the top of the page
+Quote Post

Posty w temacie


Reply to this topicStart new topic
2 Użytkowników czyta ten temat (2 Gości i 0 Anonimowych użytkowników)
0 Zarejestrowanych:

 



RSS Aktualny czas: 14.10.2025 - 23:03