La documentation est rarement mise en avant. On la juge secondaire, trop procédurale, pas assez héroïque. Et pourtant, c’est souvent elle qui reste quand l’ordinateur est refermé. J’en ai fait un principe de travail : documenter, c’est aimer un projet suffisamment fort pour pouvoir s’en éloigner.
La première fois que j’ai vraiment compris la puissance d’un guide utilisateur, c’était un mardi après-midi lourd et humide, dans une pièce où les ventilateurs faisaient plus de bruit que d’air. Nous venions de terminer un site web très simple. La page d’accueil disait l’essentiel, le calendrier fonctionnait, et la page “faire un don” se remplissait en trois clics. J’aurais pu m’arrêter là, sourire, prendre une photo et considérer la mission comme terminée.
À la place, j’ai ouvert un document vierge et j’ai écrit : “Mettre à jour la page actualités — étape 1.” Puis j’ai continué, image après image, capture d’écran après capture d’écran. À la fin, nous avions un guide d’une dizaine de pages, qui commençait par “Bonjour” et se terminait par “Vous pouvez le faire”.
Ce soir-là, je me suis sentie utile d’une autre manière. Non pas parce que j’avais “fait” quelque chose, mais parce que je pouvais partir sans emporter le projet avec moi.
Pourquoi la documentation change tout pour une ASBL ou une ONG
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 prendra le relais, ou à celle qui devra rouvrir l’outil un lundi matin, quand tout clignote en même temps.
La documentation oblige à faire exister l’autre dans son propre contexte, pas dans le nôtre.
On pourrait croire qu’il s’agit d’un besoin de contrôle. C’est exactement l’inverse. Je documente pour perdre volontairement le contrôle : pour que l’équipe puisse adopter l’outil, l’adapter, le détourner, voire le supprimer si nécessaire. En d’autres termes, pour qu’elle puisse vivre sans moi.
Au début de mes années de digital nomad, j’ai souvent croisé des outils brillants en apparence, mais dont la lumière s’éteignait dès que la personne qui les avait créés refermait son ordinateur. La documentation était absente, ou écrite pour des clones : “cliquez ici, évidemment”. Or 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.
Une documentation utile : simple, claire, transmissible
Aujourd’hui, je prépare mes livrables comme on prépare un kit de voyage : l’essentiel, rien de plus.
un guide pas à pas qui montre sans supposer
des modèles qui s’ouvrent sans abonnement payant
des chemins courts
des noms de fichiers compréhensibles au premier coup d’œil
et, quand c’est utile, une courte vidéo pour les personnes qui préfèrent regarder plutôt que lire
J’ai appris à aimer les choses modestes : un bouton “Publier” qu’on n’a plus peur de cliquer, une page “faire un don” qu’on sait remplir sans devoir demander de l’aide, une mini charte de dix lignes qu’on peut afficher près du bureau.
C’est cela aussi, pour moi, le renforcement de capacités : rendre un outil non seulement utilisable, mais réellement appropriable.
Documenter, c’est laisser de la place
Je me surprends parfois à penser que documenter, c’est faire de la place. Déplacer son ego pour que l’objet appartienne vraiment aux autres. Cela demande aussi d’accepter que la “bonne” manière ne soit pas forcément la mienne, que le site évolue, que les visuels changent de couleurs, que la campagne prenne une tonalité plus locale.
Et cette plasticité me rassure. Elle signifie que le projet est sorti de mon sac à dos.
On me demande parfois : “Tu n’as pas peur que tout soit abîmé ?”
Bien sûr que si. Mais je préfère largement un outil qui se transforme dans les mains de celles et ceux qui essaient de l’utiliser, plutôt qu’un outil intact, rangé dans un cloud que personne n’ouvre jamais.
La documentation amortit cette peur. Quand on sait qu’on peut revenir en arrière, on ose avancer.
La documentation comme geste de soin
Il m’arrive d’écrire des phrases qui ne sont pas techniques du tout.
“Vous avez le droit de vous tromper ; pensez à enregistrer souvent.”
Ou encore : “Si vous êtes perdu·e, arrêtez-vous et buvez un verre d’eau.”
Ce ne sont pas des lignes de code. Ce sont des phrases de soin. Elles murmurent : ce que vous faites a de la valeur, et vous êtes capable de le faire.
La documentation n’est pas seulement une carte. C’est aussi une main posée sur l’épaule.
Documentation, transmission et autonomie : le cœur de Nomad Impact
Au Cambodge, avec le CFSWF, j’ai mesuré à quel point cette transmission comptait. Nous avons travaillé sur des supports visuels et des guides qui expliquaient autant le pourquoi que le comment : pourquoi ce vocabulaire, pourquoi cette prudence, comment protéger sans étouffer la parole.
À Chiang Mai, avec Empower ou Thai Freedom House, les échanges portaient aussi sur des sites simples, faciles à maintenir, avec des sections claires et peu de friction. Dans tous les cas, mon défi reste le même : réduire la distance entre l’envie d’agir et les outils pour agir.
Un outil bien documenté n’est pas seulement utilisable. Il devient adoptable.
Prendre le temps de documenter, c’est investir dans l’impact
Dans un monde qui va vite, la documentation paraît lente. Elle prend une heure qu’on aurait pu consacrer à peaufiner un visuel ou à aligner des pixels. Pourtant, je vois ce temps comme de l’impact différé.
C’est ce qui permet à une équipe de publier pendant que je dors.
C’est ce qui lui permet de modifier une information sans planifier un appel.
C’est ce qui lui permet de faire vivre une campagne sans attendre la permission invisible que trop de “prestations” finissent par imposer.
Je n’idéalise pas la pratique. Parfois, documenter est répétitif. Parfois, je réécris la même étape une troisième fois parce qu’un écran ne ressemble jamais tout à fait au précédent. Mais c’est précisément là que se joue quelque chose d’important : rendre l’outil plus simple que l’obstacle.
Et pour moi, c’est sans doute cela, transmettre : créer des outils assez clairs pour continuer à vivre sans leur auteur.