Le vrai problème de la documentation projet
Les chefs de projet ne manquent pas de documentation. La plainte récurrente n’est jamais “il n’y a rien d’écrit” mais plutôt “je ne trouve pas ce dont j’ai besoin” ou “ce document ne répond pas à ma question”. La racine du problème est rarement technique: elle est structurelle, la plupart des documents projet essayant de remplir plusieurs fonctions à la fois et finissant par n’en remplir aucune correctement.
Une charte de projet qui inclut des instructions opérationnelles. Un guide de procédure qui commence par trois pages de justification méthodologique. Un wiki dont chaque page mêle contexte stratégique, données de référence et tutoriels pour débutants. Ces documents ont tous été écrits avec de bonnes intentions, mais leur structure les rend difficiles à consulter au moment où quelqu’un en a réellement besoin.
Un cadre venu de la documentation technique
Le framework Diátaxis (du grec dia, à travers, et taxis, arrangement) a été conçu par Daniele Procida pour structurer la documentation logicielle. Mais le problème qu’il résout n’a rien de spécifique à l’informatique: c’est celui de la confusion entre les types de contenu. Son adoption par des organisations bien au-delà du développement logiciel confirme que le diagnostic est universel.
Le principe repose sur deux axes croisés. Le premier distingue le contenu orienté action du contenu orienté connaissance. Le second sépare les situations d’apprentissage des situations de travail effectif. Ces deux axes définissent quatre types de documents, chacun avec un objectif et des contraintes d’écriture propres.
Quatre types, quatre intentions de lecture
Le tutoriel accompagne un apprentissage. Il s’adresse à quelqu’un qui découvre un sujet et a besoin d’être guidé pas à pas. En gestion de projet, un tutoriel porte sur des activités comme “préparer et animer une revue de jalon pour la première fois”. Le lecteur ne connaît pas encore le processus: le document l’y conduit progressivement. Un tutoriel réussi se mesure à un critère simple: le lecteur a-t-il acquis la compétence visée en suivant les étapes?
Le guide pratique (how-to guide, c’est-à-dire un document orienté tâche pour un utilisateur déjà compétent) cible un problème spécifique. “Recalibrer un échéancier après un retard majeur” ou “Intégrer un nouveau fournisseur en cours de projet” en sont des exemples. Le lecteur sait de quoi il s’agit; il cherche une méthode applicable immédiatement. La différence avec le tutoriel est fondamentale: le guide pratique suppose la compétence, le tutoriel la construit.
La référence regroupe l’information factuelle consultable: glossaire du projet, tableau RACI (matrice assignant les rôles Responsible, Accountable, Consulted et Informed à chaque livrable), registre des parties prenantes, modèles de documents. On ne lit pas une référence de bout en bout: on y cherche un point précis. Sa qualité se mesure à sa complétude et à la facilité avec laquelle on trouve l’information.
L’explication fournit le contexte et le raisonnement. Pourquoi le projet utilise une approche hybride plutôt que purement prédictive. Pourquoi le seuil de tolérance budgétaire a été fixé à 10% et non à 5%. Ce type de contenu constitue la mémoire institutionnelle du projet, soit l’ensemble des connaissances et raisonnements accumulés par une organisation. Sans lui, les décisions passées deviennent des règles arbitraires que personne n’ose remettre en question.
Le coût réel de la confusion
Quand un document mélange les types, chaque lecteur perd du temps à extraire ce qui le concerne. Mais le coût va au-delà de l’inefficacité individuelle. La confusion documentaire produit trois effets systémiques dans les projets.
Le premier effet est l’abandon: les équipiers cessent de consulter la documentation parce que l’effort de recherche dépasse le bénéfice attendu. L’information existe mais n’est pas accessible en pratique, ce qui revient au même que si elle n’existait pas.
Le deuxième effet est la duplication informelle: faute de trouver l’information dans les documents officiels, les membres de l’équipe créent leurs propres aide-mémoire, leurs propres procédures raccourcies et leurs propres fichiers de référence. Le projet se retrouve avec plusieurs versions concurrentes de la vérité, dont aucune n’est maintenue de façon fiable.
Le troisième effet est la perte de raisonnement: quand les explications sont noyées dans des documents opérationnels, elles sont les premières à être élaguées lors des mises à jour. Le “pourquoi” disparaît, ne laissant que le “quoi” et le “comment”. Trois mois plus tard, personne ne sait pourquoi la procédure de validation comprend cette étape apparemment superflue, et quelqu’un la supprime en croyant simplifier le processus.
Diagnostic avant restructuration
La valeur de Diátaxis ne réside pas dans la création de nouveaux documents mais dans la capacité à diagnostiquer ce qui ne fonctionne pas dans les documents existants. Quand un chef de projet constate qu’un document est rarement consulté, la première question à se poser est: combien de types différents ce document tente-t-il de couvrir?
La méthode pratique consiste à prendre le document problématique, surligner chaque paragraphe selon le type auquel il appartient (tutoriel, guide pratique, référence, explication), puis observer le résultat. Un document qui alterne les couleurs à chaque paragraphe est un document qui mélange les intentions et qui, de ce fait, ne sert correctement aucun de ses lecteurs.
Ce diagnostic ne requiert pas de restructurer toute la documentation d’un coup. Il suffit de commencer par les documents les plus consultés ou les plus critiques, de séparer les contenus par type et de constater l’effet sur l’utilisation réelle. L’expérience montre qu’un document de référence débarrassé de ses sections tutorielles et explicatives est consulté significativement plus souvent, parce que le lecteur trouve immédiatement ce qu’il cherche.
La question de l’onboarding
L’axe apprentissage/travail du framework éclaire un problème concret que rencontrent tous les projets d’une certaine taille: comment intégrer un nouveau membre sans ralentir les praticiens en place? La réponse passe par la distinction entre les documents destinés à ceux qui apprennent (tutoriels, explications) et ceux destinés à ceux qui travaillent (guides pratiques, références).
Un kit d’onboarding efficace regroupe les tutoriels et les explications nécessaires pour comprendre le projet. Les guides pratiques et les références restent dans l’espace de travail courant, où les praticiens expérimentés les trouvent sans friction. Cette séparation n’est ni rigide ni coûteuse à mettre en place: elle consiste souvent à réorganiser des contenus qui existent déjà, en les attribuant explicitement à l’un ou l’autre public selon le cadre Diátaxis.