YAML n’est pas du JSON sans accolades. Il peut employer anchors, alias, tags, clés complexes et plusieurs documents. Une conversion simple peut les aplatir ou les réinterpréter.
Refuser vaut mieux que deviner
JSONYAML refuse anchors, alias, tags explicites, directives, documents multiples, doublons et clés non chaîne. L’auteur doit rendre la source explicite avant conversion.
L’analyseur cible fait autorité
Gardez l’original, comparez toute la sortie et analysez le résultat avec la bibliothèque ou l’application destinataire. JSONYAML prouve seulement qu’un document borné respecte son profil compatible JSON. Il ne valide ni schéma cible, substitution d’environnement, valeurs par défaut, déploiement ou sens métier.
Les commentaires ne sont pas des données JSON
Les commentaires YAML peuvent être lus, mais JSON n’a pas cette valeur ; ils sont omis et les preuves l’indiquent. Déplacez toute information importante vers documentation ou schéma.