Code review REST API

[maghost]

Jest Doxygen który działa jako tako w PHP

[fracz]

Z doświadczenia wiem że praktycznie każda dokumentacja generowana z kodu jest byle jaka. No bo co w niej więcej widać niż w kodzie? Nic.

Oczywiście fajna by była dokumentacja "z prawdziwego zdarzenia", najlepiej oparta na przykładach. A póki co, read the source Luke
https://blog.codinghorror.com/learn-to- ... urce-luke/

[magx2]

A póki co, read the source Luke

Jakiś czas temu implementowałem klienta Supla API w Javie i powiem, że czytanie sourca tylko po to by dowiedzieć się pod jaki URL bić żeby dostać jakąś encję to katorga. Ja poradziłem sobie tak że czytałem źródła przykładowego klienta napisanego w PHP.

Co do dokumentacji generowanej z kodu - cała Java na tym stoi (javadoc) i całkiem dobrze się to sprawdza.

[fracz]

W Javie jest prościej bo jest statycznie typowana i od razu można zawrzeć w takiej dokumentacji chociażby typy argumentów i format odpowiedzi. W PHP - wiadomo. Jeśli byłyby zadbane PHPDoce to tak, ale... nie są

[magx2]

Hah no też racja.