YAML VS RAML

First of all, create a file in the root project directories called compose.yaml. YAML is a text format that uses indentation to specify dependencies between configuration options. Be aware that incorrect indentation will cause problems with executing commands properly. - Source: dev.to / 3 days ago

Most commonly written in YAML, these files are large and complex to read and understand. And being written in YAML comes with its challenges (and quirks) since it is an additional programming language that devs need to learn. - Source: dev.to / 29 days ago

Note, that this file is a Markdown and YAML file at the same time, and as such human- and machine-readable, if the fields are filled carefully. - Source: dev.to / 5 months ago

Front matter is a bit of text at the start of a file (YAML to be exact) that is placed between two ---. - Source: dev.to / 6 months ago

Meanwhile, formats have been evolving (JSON5, YAML), config entry points are constantly changing. These fluctuations, fortunately, were covered by tools like the cosmiconfig. - Source: dev.to / 7 months ago

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