01 / Comparaison sémantique
Décidez si le formatage fait partie de la question
Utilisez une différence de texte lorsque l’indentation, les espaces ou les lignes source exactes sont importantes. Utilisez la sémantique JSON lorsque la révision porte sur les clés, les chemins d’accès, les valeurs saisies et l’appartenance au tableau, plutôt que sur la manière dont le document a été sérialisé.
La même paire peut répondre aux deux questions. Choisir le mode sémantique ne prétend pas que le formatage n’est pas pertinent ; il exclut délibérément le formatage de ce résultat.
- Utilisez des chemins stables pour identifier les modifications imbriquées.
- Garder les valeurs saisies visibles.
- Revenir en mode texte lorsque le formatage de la source est important.
02 / Comparaison sémantique
Tableau d’états et règles de tolérance explicites
L’ordre des tableaux peut avoir une signification, ou l’identité peut provenir d’une clé à l’intérieur de chaque élément. Choisissez un comportement à clé ou non ordonné uniquement lorsque le modèle de données le prend en charge et appliquez une tolérance numérique uniquement aux chemins pour lesquels une légère variation est attendue.
Les chemins ignorés doivent décrire un bruit connu et non cacher des différences inexpliquées. Avec Pro, enregistrez les règles dans un profil pour reproduire une comparaison récurrente.
- Utilisez des tableaux à clés lorsqu’un champ identifie chaque élément.
- Utilisez des tableaux non ordonnés uniquement lorsque l’ordre n’a pas d’importance.
- Gardez les chemins ignorés étroits et révisables.
03 / Comparaison sémantique
Résoudre les chemins en conservant le contexte source
Un résultat structuré doit exposer le chemin stable, le type de changement, les valeurs saisies, la gravité et une explication lisible. Gardez les sources originales disponibles afin qu’un résultat individuel puisse être interprété dans son contexte.
Appliquez délibérément les modifications prises en charge dans les deux sens. Une différence sémantique explique ce qui a changé ; il ne décide pas quel côté a raison.
