Pourquoi YAML casse plus souvent que JSON
YAML traite l'indentation comme une structure : une espace en trop ou en moins change le sens du document au lieu de lever une erreur évidente. S'y ajoute que les tabulations sont interdites par la spécification : si votre éditeur en insère, le fichier casse alors qu'il paraît parfaitement aligné.
Des valeurs qui ne sont pas ce qu'elles semblent
YAML convertit automatiquement certains littéraux. Une valeur sans guillemets comme `yes`, `no`, `on` ou `off` peut finir interprétée en booléen, et une version telle que `1.10` peut être lue comme un nombre et perdre son zéro final. La validation affiche le résultat déjà interprété, et c'est là que ces surprises apparaissent.
Là où ça fait le plus mal
Les manifestes Kubernetes, les workflows GitHub Actions et les fichiers Docker Compose sont les endroits où un YAML mal indenté coûte le plus cher, car l'erreur ne se manifeste qu'à l'exécution. Valider en local évite le cycle commit, push et attente du runner.