Organiser la documentation d’un projet (exemple)

Article de démonstration — à supprimer avant la mise en ligne. Ce texte n’engage personne et ne décrit aucune mission réelle. Il n’existe que pour visualiser la mise en page du blog : niveaux de titre, paragraphes longs, citation, liste, illustration et lien. Le script de purge livré avec le thème le supprime.

Le problème n’est pas d’écrire, c’est de retrouver

Rares sont les projets qui souffrent d’un défaut d’écrits. Comptes rendus, versions successives d’un cahier des charges, échanges de messages contenant une décision importante, tableaux annotés, présentations reprises trois fois : la matière existe presque toujours en abondance. Ce qui manque, c’est la capacité à retrouver la bonne pièce en moins d’une minute, et surtout la certitude que la pièce retrouvée est bien la dernière version.

Cette incertitude a un effet pervers bien connu : plutôt que de chercher, on redemande. Quelqu’un repose la question à quelqu’un d’autre, qui reformule de mémoire une décision prise deux mois plus tôt, et une variante nouvelle entre en circulation. La documentation n’a pas échoué parce qu’elle était absente, mais parce qu’elle n’était pas atteignable.

Le coût invisible de la dispersion

La dispersion ne se manifeste jamais comme un incident. Elle se manifeste comme une lenteur diffuse, répartie sur beaucoup de gens et beaucoup de petits moments, ce qui la rend presque impossible à imputer. Personne ne signale « j’ai perdu quelques minutes à chercher un fichier », et pourtant l’addition de ces minutes finit par peser bien plus lourd que l’effort qu’aurait demandé une organisation posée dès le départ.

Elle a aussi un coût de fin de projet, moins diffus celui-là. Au moment de la clôture, il faut rassembler ce qui a été produit, et l’on découvre que les traces sont réparties entre plusieurs espaces, plusieurs comptes, parfois plusieurs personnes qui ne sont plus disponibles.

Nommer, c’est déjà classer

Une convention de nommage est probablement le dispositif le plus rentable, parce qu’il ne demande aucun outil. Une date en tête au format qui se trie tout seul, un identifiant court de projet, un mot décrivant la nature du document, un numéro de version : quatre éléments, une seule ligne, et l’essentiel du classement se fait de lui-même dans n’importe quelle liste de fichiers.

La condition est que la convention soit écrite quelque part et rappelée au premier écart. Une convention respectée par la moitié d’une équipe est pire que pas de convention du tout : elle donne l’illusion d’un ordre et rend la recherche moins fiable, puisqu’on ignore si l’absence d’un résultat signifie que le document n’existe pas ou qu’il a été nommé autrement.

Une arborescence qui tient dans le temps

Quelques principes suffisent, et ils valent mieux qu’un plan de classement exhaustif que personne ne lira :

1. Classer par nature, pas par auteur. Les personnes changent d’affectation, la nature d’un document ne change pas.
2. Un seul endroit par document. Une copie de confort dans un second dossier devient, au premier écart, une seconde vérité.
3. Un dossier « décidé » distinct du dossier de travail. La frontière entre le brouillon et l’arrêté doit être visible sans ouvrir les fichiers.
4. Une profondeur limitée. Au-delà de trois ou quatre niveaux, plus personne ne descend, et le contenu s’accumule à la racine.

Une documentation qu’on ne sait pas parcourir n’est pas une documentation : c’est une archive.

Ce qui se périme, et ce qu’il faut garder

Tout ne mérite pas d’être conservé, et l’accumulation indifférenciée nuit autant que la perte. Les versions intermédiaires d’un document arrêté encombrent sans rien apporter, dès lors que la version finale et la trace de la décision existent. En revanche, ce qui explique pourquoi une option a été écartée mérite presque toujours d’être gardé : c’est l’information qui manque le plus cruellement lorsque la même question revient un an plus tard, portée par des personnes différentes.

Un dernier réflexe, simple à installer : à la clôture de chaque étape, consacrer une courte séance à ranger plutôt qu’à produire. Vingt minutes suffisent, à condition qu’elles soient inscrites au calendrier comme une tâche à part entière. Sans cela, le rangement est toujours ce qu’on fera « quand on aura le temps », c’est-à-dire jamais. Nous écrire pour partager votre méthode.