Chaque article JSON doit avoir un identifiant stable, un slug unique, une date de publication et une date de modification. Le fichier doit aussi annoncer sa version de schéma et sa propre date de mise à jour.
La réponse utile dépend de l’objectif de la page, des personnes autorisées à la modifier et du coût d’une erreur. Un workflow fiable sépare la décision éditoriale, la diffusion technique et la vérification finale au lieu de cacher ces trois étapes dans une seule automatisation.
La décision à prendre en premier
Versionnez les données et leur structure. Ajouter un champ optionnel est simple ; renommer ou supprimer un champ exige une migration explicite, un contrôle des lecteurs et un historique vérifiable.
Une méthode concrète
- Attribuer un identifiant immuable indépendant du titre.
- Conserver les slugs publiés ou préparer une redirection.
- Trier les clés de façon cohérente pour obtenir des différences lisibles.
- Contrôler doublons, types et dates avant chaque commit.
- Étiqueter dans Git les lots éditoriaux importants.
Contrôles avant publication
- La source de vérité est explicite et peut être restaurée.
- Les URL, les dates et les affirmations visibles correspondent à la page diffusée.
- Un relecteur humain peut reproduire le contrôle sans service caché.
Le principal piège
Réutiliser un identifiant ou régénérer tous les slugs crée collisions, liens cassés et perte de traçabilité. L’identité d’un article ne doit pas dépendre d’un champ éditable.
Prochaine étape recommandée
Écrivez un contrôle CLI qui compte les articles, repère les slugs en double et valide les champs requis dans chaque langue.