News for hackers. Stuff that matters.
Re:Ask HN: Why is there no standard for API documentation? by rocketpastsix on Thursday June 10, 2021 @05:56PM (#27466330)
JSON Schema is not documentation, it's a schema for data validation in requests and responses.
Re:Ask HN: Why is there no standard for API documentation? by is_true on Friday June 11, 2021 @10:25PM (#27480875)
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