100
The yaml document from hell (ruudvanasseldonk.com)

A 10 minute read covering some YAML edge-cases that you should have in mind when writing complex YAML files

you are viewing a single comment's thread
view the rest of the comments
[-] Ephera@lemmy.ml 29 points 4 days ago

Man, even knowing that YAML document was going to be laden with bullshit, I only spotted the unquoted version strings looking fishy.

I also really dislike how often YAML is abused to take keys as list items. Something like this, for example:

hosts:
  debian-vm:
    user: root
  database-server:
    user: sql

"debian-vm" and "database-server" are the hostname, and as such they are values. So, this should be written as:

hosts:
  - name: debian-vm
    user: root
  - name: database-server
    user: sql

And I'm not just nitpicking here. If we change the example a bit:

hosts:
  database:
    user: sql

...then suddenly, you don't know, if "database" is just one of many possible hosts or if all hosts always have a shared database with this technology.

[-] sik0fewl@lemmy.ca 9 points 4 days ago

Recently introduced myself to OpenAPI/Swagger and it's chock full of this. It's painful.

load more comments (1 replies)
this post was submitted on 03 Jan 2025
100 points (95.5% liked)

Programming

17748 readers
734 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev



founded 2 years ago
MODERATORS