Comment documenter son propre site ?

Personne ne documente son site, et tout le monde le regrette au même moment : quand il faut expliquer à quelqu’un comment il fonctionne, ou quand on y revient soi‑même après deux ans.

Ce qu’il faut y mettre

• Les accès : où ils sont, à quel nom, et où sont rangés les mots de passe. Pas les mots de passe eux‑mêmes.
• Ce qui est installé : thème, extensions, avec ce que chacune fait et pourquoi elle est là.
• Ce qui a été fait sur mesure : le code ajouté, dans quel fichier, et pour régler quel problème.
• Les échéances : renouvellement du domaine, licences, contrats, avec leur coût annuel.
• Les particularités : le réglage qu’il ne faut surtout pas toucher, et pourquoi.

Le dernier point est celui qui vaut le plus cher. C’est ce qu’aucune sauvegarde ne restaure.

Ce que cela évite

Le scénario classique : un développeur intervient, trouve un réglage qui lui paraît inutile, le retire, et casse une fonction que personne ne surveille. Il n’a rien fait de mal : rien ne lui disait à quoi cela servait.

Cela évite aussi de payer deux fois le même diagnostic. Reconstituer ce qui a été fait sur un site sans documentation prend une demi‑journée à trois jours, et c’est facturé.

Quelle forme, et où ?

Un simple document texte, deux pages, tenu à jour à chaque intervention. Pas un outil dédié, pas un wiki : ce qui demande un effort ne sera pas maintenu.

Rangé hors du site, et sauvegardé séparément. Une documentation stockée sur le serveur qu’elle décrit disparaît avec lui, exactement au moment où elle servirait.

Quand l’écrire

À chaque intervention, en trois lignes : ce qui a été fait, pourquoi, et où. C’est ce que je livre à la fin de chaque mission, et c’est la partie que les clients gardent le plus longtemps.

Si le site existe déjà sans documentation, on ne rattrape pas tout : on note ce qu’on sait, et on complète au fil des interventions. Deux pages incomplètes valent infiniment mieux que rien.

Sur le même sujet : Comment savoir si mon site est en bonne santé ? · Que contient un audit de site digne de ce nom ?