Combien de sites WordPress tournent encore aujourd’hui… sans que personne ne sache vraiment comment ils fonctionnent ? 👀

Un projet lancé en 2012, un dev freelance qui a disparu dans la nature, deux changements d’équipe plus tard… et voilà : plus personne ne sait pourquoi il y a une redirection vers /old-landing-bis-v2 ou ce que fait ce fichier weird_custom_script.php. 🤷‍♂️

C’est un classique : la mémoire du projet s’évapore.
Et là, c’est la panique dès qu’il faut toucher à quelque chose. « On met à jour ? On touche pas ? On prie ?

Bonne nouvelle : l’IA peut nous filer un coup de main. Elle peut analyser le code et nous dire ce qu’il fait.

C’est mieux que rien. Mais ça reste un pansement sur une jambe de bois.

Le seul vrai remède à cette dette technique silencieuse ?
Une documentation béton du code 🧱.
Claire, à jour, et pensée pour ceux qui arriveront plus tard sur le projet.

Mais documenter, ça ne veut pas dire noyer le code sous les commentaires.
Il y a deux extrêmes qu’on observe souvent :
– Trop de doc : la moitié ne sert à rien
– Pas de doc du tout : pas un seul commentaire, même là où c’est tordu

Alors comment savoir si le niveau de doc est bon ? Une règle simple :
👉 Si vous reveniez sur ce fichier dans 2 ans, est-ce que vous comprendriez ce que vous avez fait ? Si la réponse est « non »… c’est qu’il manque quelques lignes. 😅

C’est sans doute à ce moment-là que l’IA est la plus utile : elle prémâche le travail de documentation, il n’y a plus qu’à relire et à ajuster.

Et vous, vous documentez comment vos projets WordPress ? Des outils à recommander ? Des habitudes à partager ?