Kiedy potrzebujemy, aby projekt był rozwijany przez więcej niż jedną osobę, zachodzi potrzeba wykonywania dodatkowych czynności. Jedną z nich jest pisanie dokumentacji dla kodu. W przypadku PHP, bo o nim będzie dalsza część artykułu, najszerzej stosowany jest phpDocumentor. Ma on jedną wielką zaletę: jest dostosowany do potrzeb PHP w stu procentach. Ma swoje mankamenty, ale o tym nie dzisiaj. Dzisiaj o świetnej, ciągle rozwijanej(w przeciwieństwie do phpDocumentor) alternatywy tego projektu, którą jest Doxygen. Jego głównym zadaniem jest generowanie dokumentacji dla projektów C i C++, lecz, dzięki podobieństwu składni PHP do C++, można go z powodzeniem używać do dokumentowania kodu PHP. Dzięki dużej zgodności składni komentarzy phpDocumentor i Doxygen, nie musisz się martwić, że przez tę zmianę utracisz szczegółowe podpowiedzi kodu w swoim IDE. Warto mieć na uwadze, że w poniższym artykule nie znajdują się wszelkie możliwe sposoby na wykonanie jednej i tej samej rzeczy, aby nie przerazić początkujących.
read more
Skontaktuj się ze mną!
- Łukasz Rutkowski: