Skip to content

Comment on Ask HN: Why is there no standard for API documentation?

Comments

One is json schema. The other very good one is stripe API docs.

JSON Schema is not documentation, it's a schema for data validation in requests and responses.

He was talking about docs. JSON's is great, I was trying to make some guys understand and error on the syntax of a pretty big financial institution and after a couple of mails I just send them on of the pictures from the JSON docs and they got what they were doing wrong. The picture was just a diagram of how the parser works

AboutSource Built by g1lg1l

Hackerly is an independent reader for Hacker News, built on the public HN API. Not affiliated with Y Combinator.