Pourquoi la documentation est importante pour le SaaS : le ROI caché
La documentation est la seule partie de votre produit qui fonctionne lorsque personne n'est en service. Elle répond à 3h du matin, dans un résultat de recherche, à l'intérieur d'un assistant IA, et dans les dix premières minutes d'une évaluation. Cette page explique les mécanismes par lesquels la documentation génère de l'argent, et comment les mesurer sur votre propre produit au lieu de faire confiance à une moyenne de l'industrie.
Nous créons Docsbook. Chaque chiffre ci-dessous est un que vous mesurez vous-même — nous ne publions pas de pourcentages de référence que nous ne pouvons pas justifier.
Quel est le coût d'une mauvaise documentation ?#
Une mauvaise documentation ne crée pas de ligne de coût. Elle déplace le coût sur trois équipes qui ont déjà un budget : le support, l'intégration des ingénieurs et les ventes. C'est pourquoi elle reste invisible dans un tableur et coûte cher en pratique.
Les trois transferts, dans l'ordre où la plupart des entreprises les remarquent :
- Support. Une question à laquelle la documentation ne répond pas devient un ticket. Votre équipe de support passe sa journée à être une interface de recherche plus lente et plus coûteuse pour des connaissances que vous possédez déjà.
- Intégration. Un nouvel ingénieur qui ne trouve pas la réponse la reconstruit en lisant le code source ou en demandant à un collègue. Les deux coûtent plus cher que de lire une page, et le collègue paie aussi.
- Adoption et évaluation. Une fonctionnalité que personne ne peut trouver est une fonctionnalité que personne n'utilise. Un évaluateur qui ne peut pas répondre à "est-ce que cela fait X ?" dans les cinq premières minutes suppose que cela ne le fait pas.
Comment puis-je mesurer le coût d'une mauvaise documentation sur mon propre produit ?#
Mesurez les transferts, pas les docs. Quatre comptes, tous que vous pouvez tirer cette semaine :
| Ce qu'il faut compter | Où cela se trouve | Ce que cela vous dit |
|---|---|---|
| Tickets dont la réponse existe déjà dans les docs | Boîte de réception du support, étiquetée pendant un mois | Combien de support est un problème de trouvabilité |
| Recherches sur votre site de docs qui n'ont rien retourné | Journal de recherche du site de docs | Les mots exacts que les lecteurs utilisent que vos pages ne contiennent pas |
| Questions auxquelles votre assistant de docs n'a pas pu répondre | Journaux de chat AI | Gaps exprimés sous forme de questions, dans la formulation du lecteur |
| Pages que les lecteurs atteignent et quittent immédiatement | Analytique des docs | Pages qui correspondent à une requête mais n'y répondent pas |
Les deux premiers sont les moins chers et les plus convaincants. Un mois de tickets étiquetés transforme "notre documentation pourrait être meilleure" en une liste avec des comptes à côté.
Pourquoi tant d'entreprises SaaS se trompent-elles encore à ce sujet ?#
La documentation n'a pas de propriétaire dans la plupart des organisations. L'ingénierie l'écrit sous pression, le marketing ne la considère pas comme un canal, et le support hérite des conséquences sans pouvoir corriger la cause. Aucun objectif trimestriel ne change lorsqu'une page s'améliore, donc personne ne modifie la page.
La deuxième raison est que le travail est invisible jusqu'à ce qu'il soit mesuré. Le volume des tickets de support est rapporté ; "les tickets qu'une page aurait pu prévenir" ne sont rapportés nulle part par défaut.
À quoi ressemble le paysage de la documentation en 2026?#
Les outils se divisent en deux familles, et choisir la mauvaise famille coûte plus cher que de choisir le mauvais produit au sein d'une famille.
| Famille | Exemples | Vous possédez | Vous ne possédez pas |
|---|---|---|---|
| Générateurs de sites statiques | Docusaurus, VitePress, MkDocs Material, Starlight | Contrôle total du thème et de la construction | Hébergement, recherche, mises à jour, fonctionnalités AI |
| Plateformes gérées | Docsbook, GitBook, Mintlify, ReadMe | Contenu | Construction, hébergement, recherche, AI, analyses |
Les générateurs statiques coûtent des heures d'ingénierie et pas d'abonnement. Les plateformes gérées coûtent un abonnement et pas d'heures d'ingénierie. Les deux échouent de la même manière lorsque personne ne possède le contenu.
Pour un comparatif détaillé, voir les alternatives à Docusaurus en 2026, GitBook vs Docsbook et comparaison de l'hébergement gratuit de documentation.
Qu'est-ce que Docsbook change à ce sujet ?#
Docsbook publie le Markdown déjà dans votre dépôt GitHub en tant que site de documentation et rapporte ce que les lecteurs en ont fait. Les mécanismes, pas les promesses :
- La source de vérité reste dans Git. Les documents sont modifiés dans la même demande de tirage que le code qui a changé, donc une page devenant obsolète est visible lors de la révision plutôt que découverte par un client.
- Le site est lisible par des machines. Docsbook publie
llms.txtet exécute un serveur MCP, donc un assistant répondant à une question sur votre produit peut lire vos pages plutôt que de deviner. Voir Serveur MCP pour la documentation. - L'assistant répond à partir de vos pages indexées. Un lecteur qui aurait ouvert un ticket obtient la réponse sur la page à la place, dans les mots qu'il a utilisés pour demander.
- Les analyses rapportent les lacunes sous forme de questions. Les recherches échouées et les questions sans réponse de l'assistant arrivent sous forme de liste de choses à écrire, dans les propres mots du lecteur. Voir analytique de documentation : quoi suivre.
Comment savoir si ma documentation est suffisante ?#
Répondez à ces quatre questions avec des preuves plutôt qu'avec des opinions. Chacune correspond à un compte du tableau ci-dessus.
- Un nouveau développeur peut-il atteindre un premier résultat fonctionnel sans demander à une personne ?
- Les dix questions de support les plus courantes sont-elles répondues sur une page, chacune trouvable par les mots utilisés par le client ?
- Un moteur de recherche ou un assistant IA renvoie-t-il votre page pour une question sur votre produit, ou renvoie-t-il celle de quelqu'un d'autre ?
- Lorsqu'un lecteur recherche sur votre site de documentation et ne trouve rien, quelqu'un voit-il cette recherche ?
Si l'une de ces questions n'a pas de réponse, la solution est une mesure, pas une refonte.
Quel est le coût de Docsbook ?#
Docsbook est basé sur un système de paiement à l'utilisation plutôt que sur des paliers. Chaque projet a son propre solde, et ce solde est dépensé pour l'utilisation de l'IA — le site lui-même, son hébergement, la lecture et la recherche ne le diminuent pas. Les chiffres actuels se trouvent sur docsbook.io/pricing, qui est généré à partir des constantes de tarification en direct à chaque demande ; un prix copié dans un article de blog devient obsolète silencieusement, alors lisez-le là-bas.
Publiez votre dépôt existant, puis consultez les recherches échouées pendant une semaine.
Commencez gratuitement — pas de carte de crédit
Étapes suivantes#
- Analyse de la documentation : ce qu'il faut suivre — les métriques derrière les comptes sur cette page
- Guide SEO de la documentation — rendre les pages trouvables une fois qu'elles existent
- Comment faire citer votre documentation par ChatGPT — la moitié orientée vers l'assistant de la découverte