Retour au blog Bonnes Pratiques - 5 min

Journal des changements : retrouver ce qui a bougé sur le site

Tenir un journal des changements utile en incident : date, auteur, environnement, quoi, pourquoi, et comment revenir en arrière.

Un journal des changements est une liste datée de ce qui a été modifié sur le site. Il sert le jour où une page casse, où les ventes baissent, ou où personne ne se souvient pourquoi une redirection existe. Sans lui, on compare des souvenirs. Avec lui, on regarde ce qui a été déployé dans l’heure précédant l’alerte.

Ce n’est pas la gouvernance, qui dit qui a le droit de décider. Ce n’est pas l’inventaire, qui dit chez quel fournisseur se trouve le DNS. Le journal dit ce qui a bougé, quand, et comment l’annuler. Le cadre des rôles est dans la gouvernance du site.

Ce qui mérite une ligne

Notez ce qui peut expliquer un comportement différent du site. Laissez de côté la typo corrigée dans un paragraphe.

  • Mise en production de thème, de code ou de dépendance.
  • Installation, mise à jour ou suppression d’un plugin, surtout s’il touche au cache, au SEO, au paiement ou aux formulaires.
  • Changement DNS, de certificat, d’hébergement ou de CDN.
  • Redirections ajoutées en nombre, canonical, noindex sur un modèle.
  • Import de catalogue, changement de prix global, modification d’un modèle de page.
  • Ouverture ou retrait d’un compte à privilèges.

Une campagne qui colle un script tiers le vendredi est exactement le genre de ligne qui manque six mois plus tard. La règle pratique : si vous ne pouvez pas le déduire en lisant une page, écrivez-le.

Un format qui tient en une minute

Une ligne, pas un compte-rendu. Les colonnes suivantes suffisent. Tout le monde les remplit de la même façon, sinon le journal devient illisible.

ColonneContenu
Date et heureAvec le fuseau, pour coller aux heures des alertes
AuteurLa personne, pas seulement le nom de l’agence
EnvironnementProduction ou recette
ChangementUne phrase : « mise à jour du plugin de cache 4.2 → 4.3 »
Raison« corrige les pages panier vides »
Retour arrière« réactiver 4.2, la sauvegarde du matin couvre la base »

Le champ « retour arrière » est celui qui manque le plus, et c’est celui qu’on lit pendant l’incident. « On verra » n’est pas un retour arrière. Si le seul retour arrière est la sauvegarde de la veille, écrivez-le, et sachez où elle est. La façon de mettre à jour WordPress sans perdre cette possibilité est décrite dans mettre à jour sans casser.

Rangez le journal là où l’équipe interne et l’agence en mission le trouvent : un fichier partagé, ou un CHANGES dans le dépôt si seuls des techniques y écrivent. Un journal dans la boîte mail de quelqu’un n’en est pas un. N’y collez pas de secrets (mots de passe, clés) : la ligne décrit le geste, elle ne le rend pas rejouable par n’importe qui lit le document.

S’en servir quand quelque chose casse

Devant une alerte ou une page bizarre, lisez le journal avant de modifier encore. Cherchez ce qui a été mis en production dans les heures précédentes. Un plugin de cache, une règle de redirection ou un DNS pointent souvent vers la cause plus vite qu’une lecture du code.

Si la ligne contient un retour arrière, appliquez-le, puis vérifiez l’URL. Ajoutez une nouvelle ligne pour le retour arrière lui-même : « 14 h, retour au plugin 4.2, la 4.3 vidait le panier ». L’historique reste honnête.

Quand aucune ligne ne correspond à l’heure de l’incident, vous avez appris autre chose : soit la cause est externe (hébergeur, attaque, quota), soit quelqu’un a changé la production sans l’écrire. Le second cas se traite en rappelant la règle, pas en ouvrant un outil de plus. Une checklist de maintenance peut inclure « journal à jour » comme point de contrôle, à côté des mises à jour.

Relisez le journal une fois par mois pendant un quart d’heure. Les lignes incompréhensibles se réécrivent tant que l’auteur s’en souvient. Les changements récurrents sans retour arrière (des mises à jour « on espère que ça passe ») montrent où préparer une recette, pas où rallonger le tableau.

Questions fréquentes

Que faut-il noter dans le journal ?

Chaque changement qui peut expliquer un incident ou une baisse : mise en production, plugin, DNS, redirections, certificat, contenu de masse, thème. Pas chaque correction de faute sur un article.

Le journal remplace-t-il Git ou la sauvegarde ?

Non. Git et la sauvegarde gardent les fichiers et la base. Le journal dit, en une ligne lisible par quelqu’un qui n’ouvre pas le dépôt, ce qui a été fait et pourquoi. Les deux se complètent.

Qui doit écrire une ligne ?

La personne qui fait le changement, au moment où elle le fait, pas le lendemain de mémoire. Sur une PME, c’est souvent le référent technique ou l’agence, avec une règle simple : pas de mise en production sans ligne.

Surveiller mes URL