Comment by voidUpdate

13 hours ago

> "To that end, configuration is defined in a YAML file called the request collection"

Genuine question, why do people use YAML? I've been using it a little bit recently (reading existing documents, not writing my own), and it just seems like a more overcomplicated and less human-readable version of JSON? With potential security vulnerabilities?

If not using any esoteric features, it's more human readable (imo), easier to write, can have comments and has some useful features like different kind of multi-line values. JSON is valid YAML, by the way.

> less human-readable version of JSON

Please provide an example, how YAML can be less readable than JSON. I struggle to think of any.

  • Indentation based structure isn't really a good thing in my eyes, where the format of the document encodes semantic meaning. With JSON, you can display it how you want, and because it's bracketed it will still encode the same data.

    Also I really don't like the hyphen notation... This is very unreadable to me:

      - a
      - b: c
      - - d

  • YAML:

      - - "hello"
    

    YAML expanded:

      -
        - "hello"
    

    JSON (typical formatting):

      [
        [
          "hello"
        ]
      ]
    

    And EDN for good measure:

      [["hello"]]
    

    I know which one I prefer :) Silly example perhaps, but once you have X lists nested in Y lists, it does become a lot easier to see why some prefer a bit more visually hierarchically stronger syntaxes

People use YAML because a bunch of other people use YAML. Whatever its warts, there's no use resisting it.

There’s lots of overengineered features in YAML that are problematic, but at a high level, it’s much, much more human-friendly than JSON. And if you love JSON, good news: it’s 100% valid YAML.

Because as long as you stay away from anchors and inline JSON, YAML is a perfectly workable, structured, human-readable format that supports comments.