Documentation technique : pourquoi Slack n’est pas un outil de documentation

Pourquoi ta documentation technique ne devrait jamais vivre dans Slack (ni ailleurs)

Si tu bosses dans la tech, tu vois très bien le tableau.

• Un incident en prod.
• Une décision d’archi prise vite fait.
• Un fix “temporaire” qui devient permanent.
• Une procédure de déploiement expliquée en 12 messages, à 23h47, par la seule personne qui savait.

Et tout ça finit… dans Slack.

Sur le moment, ça donne l’illusion que c’est ok. Parce que l’équipe a “parlé”. Parce que l’info a “circulé”. Parce que quelqu’un a “répondu”.

Sauf qu’en vrai, Slack n’est pas un outil de documentation. C’est un outil de conversation. Et confondre les deux, c’est poser une bombe à retardement sous ton équipe.

Ce que je vais te dire ici vaut autant pour les équipes tech que pour mes clientes. Parce que derrière la “documentation”, il n’y a pas juste un sujet d’outil. Il y a un sujet de structure, de charge mentale, de continuité, et de sécurité.

Le piège des messages éphémères

Slack est parfait pour :

• se coordonner vite
• poser une question
• débloquer un truc
• échanger en temps réel

Mais Slack a un énorme défaut quand tu l’utilises comme une base de savoir : les messages ne sont pas faits pour durer.

Déjà, factuellement, Slack en version gratuite conserve l’historique pendant 90 jours. Donc oui, au bout d’un moment, les infos disparaissent. Pas “peut-être”. Ils disparaissent.

Et même quand tu as la version payante, le problème est le même :

• tu ne sais plus où chercher
• tu ne sais plus si l’info est à jour
• tu retombes sur 4 réponses différentes, à 6 mois d’écart
• tu perds du temps à reconstruire ce qui aurait dû être posé une fois, proprement

Résultat : ce qui ressemble à de la communication devient une perte de savoir.

Et une équipe qui perd son savoir, c’est une équipe qui s’épuise.

Le vrai problème : toutes les messageries “jetables”

Slack est juste le cas le plus visible en équipe tech. Mais le même piège existe partout, dès qu’on laisse de l’info importante vivre dans des outils faits pour “parler”, pas pour “faire mémoire”.

• WhatsApp, Telegram, Signal : Ça va vite. C’est pratique. Et ça devient très vite un endroit où on “décide”. Sauf que c’est introuvable, non structuré, et souvent inaccessible à celles qui n’étaient pas là au moment où ça a été dit.
• Messageries des réseaux sociaux (Instagram, LinkedIn, etc.)Le sujet se mélange avec le relationnel. Les infos se perdent dans des DM. Et ce qui devait être un échange ponctuel devient une pseudo-base de suivi, sans historique exploitable.
• Email, surtout quand il n’y a pas d’objet clair et pas de fil propreUn email sans objet précis, c’est une doc invisible. Et même avec un objet correct, si tu ne gardes pas un fil propre, tu te retrouves avec :
  • des “Re: Re: Re:” illisibles
  • des morceaux de contexte dans des réponses partielles
  • des décisions noyées entre des phrases de politesse
  • des pièces jointes et des versions multiples impossibles à suivre

Dans tous les cas, le résultat est le même : l’info vit dans un flux, pas dans un système.

Et un flux, par définition, ça ne sert pas à transmettre du savoir. Ça sert à réagir. Ça sert à répondre. Ça sert à “avancer”. Jusqu’au moment où tu dois retrouver, expliquer, justifier, sécuriser.

Le point commun entre tous ces outils : ils donnent l’illusion que l’info existe, alors qu’en réalité elle n’est ni trouvable, ni maintenable, ni transmissible.

Ce qu’une équipe structurée met en place

Une équipe structurée ne documente pas “par plaisir”. Elle documente parce qu’elle veut pouvoir fonctionner sans dépendre d’une mémoire fragile.

Elle met en place une documentation centralisée :

• Notion
• Confluence
• Google Docs
• un wiki interne

Peu importe l’outil, tant qu’il y a un endroit clair.

Et surtout, elle fait trois choses simples, mais non négociables :

1. Des procédures écrites et accessibles

Le déploiement, l’onboarding, la gestion d’incident, les conventions… tout ce qui est critique doit être trouvable en moins de 2 minutes.

2. Un référentiel unique qui sert de source de vérité

Un endroit où, quand tu lis, tu sais que c’est “la” version officielle. Pas “la version de quelqu’un, à un moment”.

3. Une mise à jour officielle à chaque évolution

Quand un process change, la doc change. Sinon ce n’est plus une doc. C’est un piège.

Et c’est là que beaucoup d’équipes se mentent : elles croient que “documenter” c’est faire un doc une fois, puis passer à autre chose.

Non.

Documenter, c’est maintenir une mémoire vivante.

Mémoire orale vs structure documentée

La transmission orale peut fonctionner.

• Dans une petite équipe.
• Quand tout le monde se connaît.
• Quand il y a peu de sujets.
• Quand il n’y a pas de turnover.
• Quand ça ne scale pas.

Donc oui, temporairement, ça peut tenir.

Mais dès qu’il y a :

• une nouvelle personne qui arrive
• une montée en compétence à faire
• une croissance
• une réorg
• une personne clé qui part en congé

… tout s’effondre.

Et souvent, la première catastrophe révèle les failles.

Le jour où tu as un incident sérieux, tu découvres brutalement que :

• personne ne sait exactement quoi faire
• “on a déjà eu ce bug” mais personne ne retrouve la solution
• les décisions du passé sont introuvables
• tout repose sur 1 ou 2 personnes

Ça, ce n’est pas un problème d’outil.

C’est un problème de structure.

Pourquoi c’est un travail de senior

Documenter, c’est rarement “valorisé”.

Ce n’est pas glamour.

Ça ne fait pas briller.

Ça ne donne pas une dopamine immédiate.

Et pourtant, c’est un vrai travail de senior.

Parce que construire une mémoire d’équipe, c’est de l’architecture invisible.

C’est voir :

• ce qui est critique
• ce qui va casser plus tard
• ce qui doit être standardisé
• ce qui doit être clarifié
• ce qui doit être accessible même en stress

Créer des playbooks, des procédures, des pages de référence, ce n’est pas “faire de la paperasse”.

C’est poser les fondations pour scaler sans exploser.

Et oui, ça demande de la maturité.

Parce que ça demande de penser long terme, et pas juste “au prochain sprint”.

Quand la documentation manque : qui paye le prix ?

Quand il n’y a pas de doc claire, quelqu’un finit toujours par compenser.

Et ce sont souvent :

• les personnes consciencieuses
• celles qui portent le truc “pour que ça marche”
• celles qui pensent à l’équipe, au client, au futur
• celles qui prennent sur elles
• Donc elles cherchent.
• Elles reconstituent.
• Elles demandent à droite à gauche.
• Elles réexpliquent 10 fois.
• Elles prennent des notes “pour les autres”.
• Elles deviennent un support humain.
• La charge mentale explose.

Et avec ça, le stress monte, surtout quand tu utilises des outils sans les maîtriser vraiment, et que tu sais qu’une erreur peut coûter cher.

Ce n’est pas juste “désagréable”.

C’est un système qui abîme les gens.

Ce que tu peux faire (même si ce n’est pas ton rôle officiel)

Tu n’as pas besoin d’être “la personne en charge de la doc” pour commencer à assainir ça.

Tu peux faire trois choses très concrètes :

1. Proposer de centraliser les infos importantes

Pas tout. Pas chaque conversation. Juste ce qui est critique et récurrent.

2. Créer ou enrichir un document de référence accessible

Une page “Déploiement”.

Une page “Incidents”.

Une page “Décisions d’archi”.

Une page “FAQ interne”.

Petit à petit, tu construis un socle.

3. Faire le pont entre le flux et la doc officielle

Les messageries redeviennent l’endroit où l’on se parle.

Et la doc devient l’endroit où l’on conclut.

Une règle simple :

• discussion dans le flux
• décision dans la doc
• lien posté dans le flux

Ça, c’est propre.

Ça, c’est durable.

Ça, c’est respirable.

Mot de la fin

Documenter, ce n’est pas bureaucratique.

• C’est protéger ton équipe.
• C’est sécuriser tes process.
• C’est éviter que le savoir se volatilise.

C’est permettre à tout le monde de travailler sereinement, sans dépendre d’une personne, d’une mémoire, ou d’un historique introuvable.

Et c’est exactement pour ça que je travaille étape par étape, et que je documente tout.

Parce que quand tu poses une structure claire, tu arrêtes de survivre en permanence.

Et retiens cette règle : si c’est critique, ça ne vit pas dans un message jetable.