Hacker News new | ask | show | jobs
by hacker_123 2548 days ago
I similarly cringe at vaguely documented APIs, but being a young developer, my experience with REST has been better. For instance, I've consumed a SOAP API where the WSDL specification was primarily a method named "Magic" that accepted a string "Method" and six string-typed parameters, "Parameter1" through "Parameter6".

I think the key is to pick a documentation tool that the team will actually use.