News for hackers. Stuff that matters.
Re:Ask HN: Do you use automated tools to create APIs, or do ... by hacker_123 on Monday June 24, 2019 @01:27PM (#20266019)
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.

There are no comments on this comment yet.