![]() |
![]() |
![]()
Post
#1
|
|
Grupa: Zarejestrowani Postów: 41 Pomógł: 0 Dołączył: 12.09.2006 Skąd: znad klawiatury Ostrzeżenie: (0%) ![]() ![]() |
Podczas dokumentowania projektow mam niedomiennie ten sam problem. PHPDocumentor generuje z założenia dokumentację dla klas. Kontroler klasą nie jest i co za tym idzie jest ignorowany podczas tworzenia dokumentacji. Dla mnie kontroler, jako element spinający całość, jest najlepszym miejszcem do zawarcia najobszerniejszego opisu.
Jak wy rozwiązujecie problem dokumentacji kontrolera i całości aplikacji/modułu? Czy korzystacie z innych narzędzi? Jak dla mnie PHPDocumentor jest najwygodniejszy, bo znajduje się w ZDE, którego używam. |
|
|
![]() |
![]()
Post
#2
|
|
Grupa: Przyjaciele php.pl Postów: 5 724 Pomógł: 259 Dołączył: 13.04.2004 Skąd: N/A Ostrzeżenie: (0%) ![]() ![]() |
Tzn. masz tego switch'a w glownym pliku, poza jakakolwiej funkcja i chceszgo zdukumentowac?
Tak sie nie da. Wrzuc to wszystko w jedna klase, a kazda akcje wstaw do osobnej funkcji:
// choc i tak przyda sie automatyczne wywolywanie funkcji (IMG:http://forum.php.pl/style_emoticons/default/smile.gif) No i teraz masz funkcje klasy ktore phpdoc zauwazy. |
|
|
![]()
Post
#3
|
|
Grupa: Zarejestrowani Postów: 41 Pomógł: 0 Dołączył: 12.09.2006 Skąd: znad klawiatury Ostrzeżenie: (0%) ![]() ![]() |
Tak, ale wracamy do punktu wyjścia.
Chyba faktycznie phpDoc zmusi mnie do robienia wszystkiego porządnie i tworzenia klasy kontrolera zamiast kontrolera strukturalnego (IMG:http://forum.php.pl/style_emoticons/default/tongue.gif) W każdym razie dziękuję wam za pomoc. I zmuszenie do porzucenia nieprawidłowych nawyków (IMG:http://forum.php.pl/style_emoticons/default/aaevil.gif) Ale to już w wersji 1.1 tego modułu (IMG:http://forum.php.pl/style_emoticons/default/tongue.gif) 1.0 własnie rusza do Klienta. |
|
|
![]() ![]() |
![]() |
Aktualny czas: 15.10.2025 - 18:29 |