On parle rarement de documentation. On la considère secondaire, trop « procédurale », pas assez héroïque. Pourtant, c’est ce qui reste quand l’ordinateur est rangé. J’en ai fait mon principe directeur : documenter, c’est aimer assez un projet pour pouvoir s’en détacher.
La première fois que j’ai vraiment compris la force d’un mode d’emploi, c’était un mardi après-midi lourd, dans une pièce où les ventilateurs faisaient plus de bruit que d’air. On venait de terminer un site très simple. La page d’accueil disait l’essentiel, l’agenda fonctionnait, et il fallait trois clics pour donner. J’aurais pu m’arrêter là, sourire, prendre une photo. À la place, j’ai ouvert un document vierge et écrit : « Mettre à jour la page “actualités” — étape 1. » Puis j’ai continué, image après image, capture après capture. À la fin, nous avions un guide de dix pages qui commençait par « Bonjour » et se terminait par « Vous pouvez le faire. ».
Ce soir-là, je me suis sentie utile autrement : non pas parce que j’avais « fait » quelque chose, mais parce que je pouvais partir sans emporter le projet avec moi.
Documenter, ce n’est pas empiler des fichiers. C’est écrire pour quelqu’un d’autre, avec sa connexion instable, son ordinateur fatigué, son temps limité. C’est choisir des mots qui n’intimident pas. C’est penser à la personne qui viendra après, ou à celle qui devra reprendre un lundi matin quand tout clignote en même temps. Documenter, c’est faire exister l’autre dans son contexte, pas le nôtre.
On pourrait croire que c’est une obsession du contrôle ; c’est l’inverse. Je documente pour perdre volontairement le contrôle : pour que l’équipe adopte, adapte, détourne, voire supprime — bref, pour que ça vive sans moi. À mes débuts de nomade du numérique, j’ai croisé des outils brillants dont la lumière s’éteignait dès que l’auteur fermait son ordinateur. La documentation était absente ou écrite pour des clones : « cliquez ici, évidemment ». Rien n’est évident quand on ne partage ni la langue, ni les habitudes, ni l’architecture mentale de la personne qui a conçu l’outil.
Aujourd’hui, je prépare mes livrables comme on prépare un kit de voyage. L’essentiel, rien de plus. Un pas-à-pas qui ne présume pas, mais montre. Des modèles qui s’ouvrent sans abonnement. Des chemins courts, des noms de fichiers que l’on comprend d’un coup d’œil. Et, quand c’est possible, une courte vidéo pour celles et ceux qui préfèrent regarder que lire. J’ai appris à aimer les choses modestes : un bouton « Publier » qu’on n’a pas peur d’appuyer, une page « faire un don » où l’on sait quoi remplir sans me demander, une charte en dix lignes qu’on épingle près de son bureau.
Il m’arrive de me dire que documenter, c’est un peu faire de la place. Mettre son ego de côté pour que l’objet appartienne aux autres. C’est aussi accepter que la « bonne » manière ne soit pas la mienne, que le site change, que les visuels prennent d’autres couleurs, que la campagne adopte une saveur locale. Cette plasticité me rassure : elle signifie que le projet a quitté mon sac.
On me demande souvent : « Tu n’as pas peur que tout soit abîmé ? » Si, bien sûr. Mais je préfère de loin un outil qui s’use dans les mains de celles et ceux qui essaient de s’en servir qu’un outil intact rangé dans un cloud que personne n’ouvre. Et puis il y a la documentation pour amortir la chute : quand on sait qu’on peut revenir en arrière, on ose avancer.
Parfois j’écris des phrases qui ne sont pas techniques du tout. « Tu as le droit de te tromper ; enregistre souvent. » Ou « Si tu es perdu·e, arrête-toi et bois un verre d’eau. » Ce sont des phrases bienveillantes, pas des lignes de code. Elles murmurent : « Ce que tu fais a de la valeur. Tu peux y arriver. » La documentation n’est pas qu’une carte, c’est une main sur l’épaule.
Au Cambodge, avec CFSWF, j’ai mesuré l’importance de cette passation. Nous avons travaillé sur des aides visuelles et des guides qui expliquent le pourquoi autant que le comment : pourquoi cette terminologie, pourquoi cette précaution, comment protéger sans étouffer la parole. À Chiang Mai, avec Empower ou à Thai Freedom House, nous parlons de sites simples à maintenir, avec des sections épurées. Mon défi est le même : minimiser la friction entre l’envie d’agir et les outils pour agir.
Un outil bien documenté n’est pas seulement utilisable ; il est adoptable.
Dans un monde pressé, la documentation paraît lente. Elle prend une heure qu’on aurait pu passer à embellir un visuel ou à aligner des pixels. J’appelle ce temps un impact différé. C’est ce qui permettra à l’équipe de publier pendant que je dors, d’ajuster une info sans planifier d’appel, de lancer sa campagne sans demander cette permission invisible que trop de « services » finissent par exiger.
Je n’idéalise pas la pratique : parfois, documenter est fastidieux. Parfois, je réécris la même étape une troisième fois parce qu’aucun écran ne ressemble tout à fait à un autre.