Code review REST API

maghost
Posty: 99
Rejestracja: ndz mar 27, 2016 12:30 am

Jest Doxygen który działa jako tako w PHP
Awatar użytkownika
fracz
Posty: 2256
Rejestracja: pt paź 28, 2016 10:56 pm
Lokalizacja: Kraków

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
Posty: 351
Rejestracja: śr maja 17, 2017 1:27 pm
Kontakt:

fracz pisze: wt sie 01, 2017 1:40 pm 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.
Java 4 Life :twisted:

API Java
GUI
Server Mock

Awatar użytkownika
fracz
Posty: 2256
Rejestracja: pt paź 28, 2016 10:56 pm
Lokalizacja: Kraków

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
Posty: 351
Rejestracja: śr maja 17, 2017 1:27 pm
Kontakt:

Hah no też racja.
Java 4 Life :twisted:

API Java
GUI
Server Mock

ODPOWIEDZ

Wróć do „CLOUD”