{"canonical_url":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/","content_markdown":"# 50 000 mots de documentation logicielle\n\nRédigé 50 000 mots de documentation logicielle complète en Markdown dans GitHub, Craft et Confluence pour conserver les connaissances et rendre le processus transparent.\n\n2022 – 2024\n\n**Situation.** L'essentiel du savoir sur le produit et le fonctionnement de l'équipe vivait dans les têtes. Cela convient jusqu'au jour où quelqu'un arrive ou part — l'intégration devient alors laborieuse, et une partie de la mémoire de l'organisation risque de disparaître définitivement à la prochaine démission.\n\n**Tâche.** L'objectif était d'extraire ce savoir des têtes pour en faire une documentation réellement conservée et utilisée : assez claire pour être lue, assez structurée pour être maintenue plutôt qu'abandonnée au bout d'un mois.\n\n**Action.** Une grande partie a été rédigée à la main, environ 50 000 mots au total, en Markdown dans GitHub, Craft et Confluence selon la place de chaque élément. Elle couvrait l'architecture, les processus et les modes d'emploi pratiques — les questions que les gens posaient sans cesse. Elle était versionnée et, tout aussi essentiel, facile à trouver, car une documentation introuvable pourrait tout aussi bien ne pas exister.\n\n**Résultat.** Le savoir a cessé d'être fragile. Les nouvelles recrues devenaient opérationnelles plus vite, le processus devenait une référence consultable plutôt qu'un récit à reconstruire de mémoire, et l'ensemble devenait auditable : il était possible de voir comment et pourquoi le travail était réalisé, au lieu de devoir le croire sur parole.\n\n---\n\n- Rôle: Responsable de produit et de développement de projets\n- Catégories: [Encadrement d'équipes](https://engineer.company/fr/categories/team-leadership/), [Direction technique](https://engineer.company/fr/categories/technical-leadership/), [Mentorat et accompagnement](https://engineer.company/fr/categories/mentoring/), [Documentation](https://engineer.company/fr/categories/documentation/)\n- Prestations: [Direction technique et conseil](https://engineer.company/fr/services/technical-leadership/), [Documentation technique](https://engineer.company/fr/services/technical-documentation/)\n\n\u003chttps://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"50 000 mots de documentation logicielle dans GitHub, Craft et Confluence pour rendre les connaissances durables, transparentes et vérifiables.","formats":{"gemtext":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/index.gmi","gopher":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/gophermap","html":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/","json":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/index.json","markdown":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/index.md","pdf":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/index.pdf"},"kind":"page","language":"fr","title":"50 000 mots de documentation logicielle","url":"https://engineer.company/fr/portfolio/wrote-50000-words-of-software-documentation/","version":1}