IBM predstavio novi open source alat za jednostavnije pisanje API dokumentacije

Aplikacijsko programsko sučelje (API) može biti nešto s čim nije lako raditi i u velikoj kompaniji kao IBM toga su itekako svjesni, zbog čega se donijela odluka predstaviti novi alat koji bi developerima trebao uvelike olakšati pisanje API dokumentacije.

Riječ je o alatu nazvanom The OpenAPI Comment Parser, bit će open source pa samim time dostupan svima koji su zainteresirani za njegovo korištenje. Hvalevrijedan potez od strane IBM-a, no nije pritom riječ o altruizmu, normalno da jedna od najbogatijih kompanija svijeta dobiva nešto zauzvrat.

A to su bitne informacije koje se prikupljaju pri radu koji developeri obavljaju. Naravno, tako nešto može biti neprocjenjivo pa su svi na dobitku.

"Developeri trebaju instrukcije kako koristiti nečiji API i moraju dobiti mogućnost isprobati ga. Dobra dokumentacija obavlja obje stvari", rekao je Nicholas Bourdakos, advokat IBM-ova razvojnog sustava rada.

Inače, OpenAPI je specifikacija načinjena kao "jezično agnostičko" sučelje za RESTful APIs, koji omogućavaju ljudima i računalima razotkriti i shvatiti mogućnosti usluge bez pristupa jezgrenom kodu, dokumentaciji ili inspekciji mrežnog prometa. Tako nešto javnosti je obznanio API tool stručnjak Swagger.

Ukratko, s Parserom će developeri zaobići probleme koje je spomenuo Bourdakos i lakše će raditi u globalu, što je iznimno bitno kad se radi o većim sustavima, projektima i uslugama. Dakle, svaka pomoć dobro dođe, a čini se da je IBM ovaj put napravio značajniji iskorak prema naprijed u tom smislu.

Ipak, da bi bilo još lakše shvatiti kako sve skupa funkcionira, Bourdakos je napravio video u kojem objašnjava rad s Comment Parserom.

Jasno je, IBM i ljudi oko njega itekako su se potrudili developerima učiniti živote lakšima no što su bili dosad...