RAML VS JSON

This happened when I was working for one of my previous employers. I had just joined the company and was working on a microservice that was consuming a REST api exposed by another microservice. There was this JIRA ticket I was working on and I was not sure about the data model exposed by this REST api call. At this point in time the adoption to OpenAPI / Swagger / RAML was just beginning. I was new and was... - Source: dev.to / over 2 years ago

Provide consistent and easy-to-use documentation. Provide an OpenAPI or RAML file that describes your API and the endpoints. Also, provide easy-to-use interactive online API documentation like Swagger if possible. - Source: dev.to / almost 3 years ago

The YAML 0.1 spec was sent to a public user group in May 2001. JSON was named in a State Software internal discussion. State Software was founded in March 2001. json.org was launched in 2002. Therefore you’re just wrong: YAML came out before JSON. Source: about 1 year ago

How come that doesn't apply to other libraries? For example, when I write Java or Node.js programs, I don't need to make sure packages like json.org or express.js have a 32bit or 64bit environment. What makes windows libs different than NPM libs? Source: over 1 year ago

The first two sentences of the text on http://json.org are "JSON (JavaScript Object Notation) is a lightweight data-interchange format. It is easy for humans to read and write." It's a primary goal of JSON, it's fair to question whether it's successful at it. Personally, I'd much rather write TOML or S expressions. I don't like YAML at all, the whitespace sensitivity drives me nuts. - Source: Hacker News / over 1 year ago

To help you make the transition, we’ve written a tutorial on how to write an MCAP writer in Python to record JSON data to an MCAP file. Source: almost 2 years ago

What you need to probably do is to step back and learn the format for JSON, and the core data structures that you will find in most languages:. Source: almost 2 years ago