FAQ Docsbook : coûts, limites, synchronisation et propriété des données
Les questions sont classées selon le moment où elles bloquent une décision : d’abord l’argent, puis la prise en main, et enfin le comportement du produit une fois que vous l’utilisez.
Coût et facturation#
Combien coûte Docsbook ?#
Docsbook comptabilise quatre éléments, tous liés à l’IA, facturés sur le solde du projet qui les a demandés :
- Lecteurs (chat IA) — une réponse d’IA donnée à un lecteur de votre documentation.
- Administration & agent IA — une exécution d’agent que vous ou un agent connecté avez lancée.
- Traductions IA — la traduction d’une page dans une autre langue.
- Index sémantique — la création des représentations vectorielles utilisées par le chat IA pour effectuer ses recherches.
Tout le reste n’est pas comptabilisé : l’hébergement du site, un domaine personnalisé et son certificat TLS, la navigation des lecteurs, la rédaction par les éditeurs, la synchronisation GitHub, la recherche en texte intégral, la personnalisation de la marque, les analyses et les appels de lecture MCP. Les chiffres actuels sont disponibles sur docsbook.io/pricing, une page générée à chaque requête à partir des constantes de facturation de Docsbook — consultez les tarifs qui y figurent plutôt qu’une page de documentation susceptible de devenir obsolète. Consultez Tarification pour comprendre le mécanisme.
Existe-t-il un moyen gratuit d’essayer Docsbook ?#
Oui. La génération d’un site brouillon ne nécessite ni compte ni carte bancaire : collez un dépôt, l’URL d’un site web ou une phrase décrivant votre produit sur docsbook.io/start et consultez le résultat avant de vous connecter. Chaque nouveau projet est ensuite créé avec un solde de 1,00 $, et 5,00 $ supplémentaires peuvent être réclamés une fois que le projet a 3 minutes. Ces deux montants constituent de vrais crédits pour le travail effectué par l’IA.
Comment commencer à dépenser et combien coûte un rechargement ?#
Le 1,00 $ avec lequel un projet Docsbook commence est immédiatement disponible : posez une question au chat IA et vous le verrez diminuer. Appuyez sur Réclamer dans la carte de facturation du projet une fois celui-ci âgé de 3 minutes pour ajouter le crédit de bienvenue de 5,00 $ ; personne ne l’ajoute à votre place.
Ensuite, vous choisissez vous-même le montant. Le plus petit rechargement unique est de 20,00 $ et le plus grand de 5 000,00 $ ; pour un montant supérieur, rechargez deux fois. L’argent est crédité sur le solde de l’unique projet que vous avez choisi. Le solde n’est pas rechargé automatiquement selon un calendrier : configurez un paiement mensuel dans l’écran de facturation si vous souhaitez un montant récurrent.
Que se passe-t-il lorsque le solde d’un projet est épuisé ?#
Le site de documentation reste en ligne. Les lecteurs continuent de naviguer, la recherche en texte intégral continue de fonctionner, la synchronisation avec GitHub continue de s’exécuter, et rien n’est supprimé. Ce qui s’arrête, ce sont les tâches d’IA facturées à l’usage : l’appel est refusé avant son exécution, et le refus indique quel projet est arrivé à épuisement, combien l’appel aurait coûté, ce qu’il reste et où approvisionner ce projet.
Les appels de découverte gratuits via MCP continuent de fonctionner, de sorte qu’un agent peut toujours signaler ce qui s’est passé au lieu d’échouer silencieusement.
Puis-je arrêter de payer, et qu’advient-il de mon site de documentation ?#
Il n’y a rien à résilier : vous rechargez le solde d’un projet quand vous le souhaitez, et arrêter signifie simplement ne plus le recharger. Votre site de documentation reste en ligne à l’adresse docsbook.io/{owner}/{repo}, vos fichiers Markdown restent dans votre propre dépôt GitHub et vos paramètres — image de marque, navigation, mise en page — sont conservés. Rien n’est supprimé.
Si vous avez configuré vous-même un paiement mensuel récurrent, mettez-y fin depuis l’écran de facturation à l’adresse docsbook.io/chat.
Mes fichiers restent-ils les miens ?#
Oui. Votre Markdown se trouve toujours dans votre propre dépôt GitHub. Docsbook effectue le rendu de ces fichiers ; il ne stocke jamais votre contenu dans un format propriétaire et vous n’avez rien à exporter au préalable. Dirigez un autre outil de documentation vers le même dépôt et vous conservez chaque page, image et lien.
Comment payer Docsbook ?#
La facturation est gérée par Paddle, qui est le vendeur officiel. Ouvrez l’écran de facturation depuis le tableau de bord à l’adresse docsbook.io/chat et rechargez le solde d’un projet — 20,00 $ au minimum et 5 000,00 $ au maximum. Les cartes Visa, Mastercard et American Express, ainsi qu’Apple Pay et Google Pay, sont acceptées.
Le paiement est-il sécurisé ?#
Oui. Les paiements sont traités par Paddle en tant que revendeur officiel, et Docsbook ne voit jamais votre numéro de carte. L'intégralité du processus de paiement s'effectue via le parcours hébergé de Paddle.
Un compte peut-il gérer plusieurs sites de documentation ?#
Oui. Un compte Docsbook peut posséder de nombreux projets, et chaque projet dispose de son propre solde. L’épuisement du solde d’un projet n’arrête pas les autres. Le projet qui paie un appel facturé à l’usage est déterminé à partir de l’appel lui-même — l’espace de travail que vous avez indiqué ou le dépôt auquel il est associé.
Proposez-vous des remboursements ?#
Envoyez un e-mail à support@docsbook.io en indiquant l’adresse de votre compte et ce pour quoi vous avez payé. Les remboursements sont traités au cas par cas via Paddle, qui a traité le paiement.
Existe-t-il des réductions pour les organisations ?#
Envoyez un e-mail à support@docsbook.io pour en discuter. Il n’existe aucune réduction publiée pour les organisations à communiquer ici.
Premiers pas#
Ai-je besoin d’un dépôt GitHub pour essayer Docsbook ?#
Non. Sur docsbook.io/start, un champ accepte ce que vous avez — l’URL d’un site web, le lien vers un dépôt, un PDF ou des captures d’écran, ou une phrase décrivant ce que vous vendez — et génère un site brouillon à partir de ces éléments. Vous arrivez sur le panneau d’administration du brouillon, avec la documentation accessible en un clic, et pouvez modifier l’identité visuelle, la mise en page et le SEO avant de créer un compte.
GitHub est nécessaire uniquement pour associer un dépôt existant ou lors de la publication. Toutes les méthodes de connexion fonctionnent : GitHub, Google, Apple ou une adresse e-mail avec un code à usage unique.
De quel type de dépôt Docsbook a-t-il besoin ?#
N’importe quel dépôt GitHub contenant des fichiers Markdown. Il peut s’agir d’un simple README.md, d’un dossier docs/, d’une référence d’API ou d’un ensemble de fichiers .md — Docsbook construit la navigation à partir de la structure existante.
Dois-je configurer quelque chose dans GitHub ?#
Non. Autorisez Docsbook via OAuth GitHub et il lit les fichiers du dépôt. Il n’y a aucun fichier de workflow à ajouter, aucune GitHub Action à installer et aucun webhook à enregistrer.
Quelle structure de dossiers dois-je utiliser ?#
N’importe quelle structure convient, car Docsbook construit l’arborescence de navigation à partir des dossiers qu’il trouve. Une structure courante :
repo/
├── README.md
├── docs/
│ ├── getting-started.md
│ ├── api/
│ └── guides/README.md à la racine d’un dossier devient la page d’accueil de ce dossier.
Puis-je utiliser .markdown au lieu de .md ?#
Oui. Docsbook lit à la fois .md et .markdown. Les fichiers dans d’autres formats — .txt, .rst, .adoc — ne sont pas transformés en pages.
Les liens entre les fichiers Markdown fonctionnent-ils ?#
Oui. Les liens relatifs entre les fichiers Markdown sont résolus vers les URL publiées, donc un lien qui fonctionne sur GitHub fonctionne sur le site. Écrivez-les comme vous le faites déjà :
[Concepts](/docsbook-io/docs/basics)
[Custom domain](/docsbook-io/docs/guides/advanced/custom-domain)Les ancres vers les titres à l’intérieur d’une page (./basics.md#indexing) sont également résolues.
Comment ajouter des images à ma documentation ?#
Placez le fichier image dans votre dépôt — docs/images/ est un choix courant — et référencez-le à l’aide d’un chemin relatif. Les fichiers PNG, JPG, GIF et WebP sont tous pris en charge.
Le texte alternatif est ce que lisent un lecteur d’écran et un robot d’exploration IA, alors décrivez ce que montre l’image plutôt que de nommer le fichier.
Puis-je utiliser du HTML dans mon Markdown ?#
Oui. Markdown autorise le HTML intégré et Docsbook l’interprète. Le Markdown standard reste néanmoins le meilleur choix par défaut, car il reste lisible sur GitHub, dans un éditeur et par un agent via MCP.
Comment basculer entre les comptes et les organisations GitHub ?#
Cliquez sur le bouton GitHub dans le coin supérieur droit du chat IA. Un sélecteur s’ouvre et affiche votre compte connecté ainsi que toutes les organisations GitHub dont vous faites partie. Un point vert sur le bouton signifie que GitHub est connecté. Survolez un compte ou une organisation — appuyez dessus sur un écran tactile — pour afficher ses dépôts, puis connectez-en un en tant que nouveau projet depuis cet emplacement.
Puis-je déplacer un projet hébergé par Docsbook vers mon propre dépôt GitHub ?#
Oui, à partir du même bouton GitHub. Docsbook crée le dépôt sur votre compte, y copie chaque page en un seul commit et y pointe le projet ; vos modifications sont ensuite directement enregistrées dans votre dépôt.
Deux conséquences à prendre en compte avant le déplacement : l’URL publique change, et l’ancienne adresse hébergée cesse de fonctionner sans redirection. Pensez donc à la mettre à jour partout où vous l’avez partagée. Et le déplacement est à sens unique — il n’existe aucun bouton permettant de replacer un projet sur l’hébergement Docsbook.
Publication et synchronisation#
Comment mettre à jour ma documentation Docsbook ?#
Modifiez le fichier Markdown et validez-le sur GitHub. Le site détecte la modification lors de la prochaine visite — il n’y a aucune compilation à lancer ni aucun déploiement à attendre. Vous pouvez également modifier le contenu dans l’éditeur web de Docsbook ou via un agent utilisant MCP : dans les trois cas, les modifications sont enregistrées sous forme de validations dans le même dépôt.
À quelle vitesse un site Docsbook se met-il à jour après un push ?#
À la prochaine visite. Docsbook vérifie la présence de nouveaux commits sur GitHub lors du chargement du site et réindexe les modifications, de sorte que la page que vous ouvrez est générée à partir de l’état actuel du dépôt plutôt qu’à partir d’une version mise en cache.
Pourquoi mon site Docsbook n’a-t-il pas été mis à jour ?#
Vérifiez ces quatre points, dans l’ordre :
- Le commit se trouve-t-il réellement sur GitHub ? Vérifiez le fichier sur github.com.
- Avez-vous actualisé complètement le navigateur (Ctrl+F5 ou Cmd+Shift+R) ?
- Une minute ou deux se sont-elles écoulées depuis le commit ?
- Le fichier se termine-t-il par
.mdou.markdown? Les autres extensions ne sont pas indexées.
Si les quatre points sont corrects, envoyez un e-mail à support@docsbook.io en indiquant le dépôt et le commit.
La recherche du site Docsbook fonctionne-t-elle ?#
Oui. Chaque site Docsbook dispose d'une recherche plein texte intégrée sur toutes ses pages. Cliquez sur l'icône de recherche dans l'en-tête, ou appuyez sur Cmd+K sous macOS et Ctrl+K sous Windows et Linux.
Existe-t-il un thème sombre ?#
Oui. Les thèmes clair, sombre et selon le système sont tous pris en charge. Le propriétaire de l’espace de travail choisit le thème par défaut dans les paramètres de personnalisation, et les lecteurs peuvent le modifier à l’aide du sélecteur de thème dans l’en-tête.
Combien de visiteurs simultanés un site Docsbook peut-il gérer ?#
Les sites Docsbook sont servis depuis le CDN de Vercel, qui évolue automatiquement. Il n’y a aucune limite de visiteurs à configurer ni aucun niveau de trafic à acheter.
Accès et confidentialité#
Qui peut voir ma documentation Docsbook ?#
Par défaut, tout le monde : toute personne disposant du lien, les personnes sans compte GitHub et les robots d’exploration des moteurs de recherche. C’est généralement ce que vous souhaitez, car il s’agit d’un site public que Google indexe et qu’un assistant IA peut citer.
Vous pouvez modifier ce paramètre — consultez la réponse suivante.
Puis-je rendre ma documentation privée ?#
Oui. Passez l’espace de travail en mode privé et les lecteurs voient un écran de déverrouillage au lieu de votre contenu, protégé soit par un mot de passe partagé, soit par votre propre fournisseur d’identité SSO. La structure, les pages et l’index de recherche restent masqués jusqu’à ce qu’un lecteur le déverrouille, et le propriétaire dispose toujours d’un accès complet.
Consultez Documentation privée : mot de passe et SSO pour la configuration.
Un dépôt GitHub privé rend-il le site publié privé ?#
Non. Les deux paramètres sont indépendants. Docsbook lit le dépôt via l’autorisation GitHub que vous avez accordée, puis diffuse les pages qu’il a générées : les personnes autorisées à lire ces pages sont déterminées par les propres paramètres d’accès de Docsbook, et non par la visibilité du dépôt.
Ma documentation est-elle servie via HTTPS ?#
Oui. Chaque site Docsbook est servi via HTTPS par le CDN de Vercel, et un domaine personnalisé obtient automatiquement son certificat TLS.
Quelqu’un d’autre peut-il modifier ma documentation via Docsbook ?#
Non, sauf si vous lui avez accordé l’accès au dépôt. Docsbook enregistre les modifications sous forme de commits dans le dépôt à partir duquel le site est généré : les autorisations du dépôt déterminent donc qui peut modifier quoi.
Qui voit le widget flottant ?#
Vous seul, lorsque vous êtes connecté et consultez votre propre documentation. Les lecteurs voient la documentation et rien d’autre : le widget flottant n’est pas du tout affiché pour eux.
Domaine personnalisé#
Comment utiliser mon propre domaine pour Docsbook ?#
Saisissez le domaine dans les paramètres de votre espace de travail, ajoutez l’enregistrement CNAME que Docsbook vous indique auprès de votre fournisseur DNS, puis attendez sa propagation. Docsbook provisionne lui-même le certificat TLS.
Guide complet : Configuration d’un domaine personnalisé.
Dois-je utiliser un domaine racine ou un sous-domaine pour la documentation ?#
Un sous-domaine, généralement — docs.example.com. Il s’agit d’un seul enregistrement CNAME et cela laisse votre domaine apex libre pour le site marketing. Un domaine racine fonctionne, tout comme plusieurs sous-domaines pointant vers différents espaces de travail.
Dois-je configurer SSL moi-même ?#
Non. Docsbook provisionne et renouvelle automatiquement le certificat TLS de votre domaine personnalisé, sans frais supplémentaires et sans aucune configuration de votre part.
Combien de temps prend la propagation DNS ?#
Généralement 15 à 30 minutes, et jusqu’à 48 heures dans le pire des cas. Le délai se situe chez votre fournisseur DNS, et non chez Docsbook — le domaine commence à fonctionner dès que l’enregistrement est résolu.
Traductions#
Comment traduire la documentation de mon espace Docsbook ?#
Ouvrez les paramètres de votre espace de travail, sélectionnez les langues cibles, puis enregistrez. Docsbook traduit les pages et sert chaque langue sur sa propre route. La traduction est effectuée par l’IA et utilise donc le solde du projet.
Guide complet : Traduction & i18n.
Quelles langues Docsbook prend-il en charge ?#
15 : anglais, espagnol, français, allemand, portugais, italien, russe, chinois, japonais, coréen, arabe, hindi, turc, polonais et néerlandais. Chaque langue est disponible sur sa propre route avec les balises hreflang appropriées, afin que les moteurs de recherche l’indexent comme une page distincte.
Quelle est la qualité de la traduction IA de Docsbook ?#
Elle est suffisamment bonne pour être publiée dans une documentation technique, où le vocabulaire est cohérent et les phrases sont courtes. Les idiomes, les plaisanteries et les exemples propres à une culture sont les cas où une relecture humaine est nécessaire : lisez ces pages avant d’annoncer la disponibilité de la langue.
Les traductions sont-elles mises à jour lorsque je mets à jour l’original ?#
Oui. Lorsque la page source change, Docsbook la retraduit afin qu’une version dans une autre langue ne diverge pas silencieusement de la version anglaise.
Puis-je modifier une traduction manuellement ?#
Oui. Les traductions peuvent être téléchargées, corrigées, puis importées à nouveau. Envoyez un e-mail à support@docsbook.io si vous souhaitez être guidé dans la procédure.
IA et agents#
Qu'est-ce que le SEO, le GEO et l'AEO, et pourquoi sont-ils importants pour la documentation ?#
Le SEO place votre documentation dans les résultats de Google. Le GEO — optimisation pour les moteurs génératifs — la place dans les réponses des IA : citations de Perplexity, ChatGPT Search, Google AI Overviews. L'AEO — optimisation pour les moteurs de réponse — ajoute le balisage structuré que lisent les extraits optimisés et les assistants vocaux.
Docsbook génère les trois à partir de votre Markdown : balises meta, sitemap.xml, OpenGraph, URL canoniques, blocs TL;DR, un dateModified visible, balisage de l'auteur, JSON-LD FAQPage et HowTo, ainsi que des sélecteurs speakable. Consultez le SEO, le GEO et l'AEO.
Que sont les compétences Docsbook ?#
Les compétences Docsbook sont des fichiers SKILL.md qui apprennent à un agent IA à effectuer des tâches de documentation. Le catalogue comprend quatre compétences d’orchestration, une par tâche : docs-analyze trouve ce qui ne va pas, docs-create rédige ce qui manque, docs-manage détermine ce qu’une page doit dire et docs-automate fait en sorte que tout cela se reproduise.
Installez-les avec npx skills add Docsbook-io/docs-skills --skill '*', ou laissez un agent connecté à MCP les découvrir à l’exécution avec find_skill. Voir les compétences Docs.
Un agent IA peut-il modifier ma documentation ?#
Oui. Le serveur MCP de Docsbook expose 309 outils à https://docsbook.io/api/mcp/server, afin que Claude Code, Cursor ou ChatGPT puissent lire vos pages, les rechercher, modifier les paramètres et valider de nouvelles pages. L’écriture nécessite un jeton autorisé avec une portée en lecture-écriture ; un jeton en lecture seule est refusé.
Consultez le serveur MCP et la référence des outils MCP.
Migrer depuis un autre outil#
Comment migrer de GitBook vers Docsbook ?#
Trois étapes :
- Exporter depuis GitBook. GitBook peut se synchroniser avec un dépôt Git ou exporter du Markdown sous forme de
.zip. Envoyez les fichiers.mdainsi obtenus vers un dépôt GitHub — n’importe quelle structure convient. - Connecter le dépôt. Collez
github.com/your-org/your-reposur docsbook.io/start. - Réorienter votre domaine. Supprimez le domaine personnalisé dans GitBook, ajoutez-le dans Docsbook et mettez à jour l’enregistrement CNAME. Le certificat TLS est provisionné pour vous.
Ce qui est transféré automatiquement : la structure des pages, les liens internes (les chemins .md relatifs sont résolus), les images, les blocs de code GFM, les titres et les métadonnées frontmatter. Ce que vous devez refaire : l’image de marque, les liens de navigation et les questions suggérées du chat IA. Comparaison côte à côte : GitBook vs Docsbook.
Qu’advient-il de mes documents si Docsbook cesse ses activités ?#
Rien n’est perdu. Vos fichiers Markdown résident dans votre propre dépôt GitHub, dans un format ouvert, avec leur historique. Dirigez un autre outil vers le même dépôt et vous conservez tout — il n’y a aucun stockage propriétaire dont il faudrait s’échapper ni aucune exportation à demander.
Assistance, juridique et technique#
Comment contacter l’assistance Docsbook ?#
Envoyez un e-mail à support@docsbook.io ou posez votre question sur le Discord de Docsbook. Incluez l’adresse de votre projet — docsbook.io/{owner}/{repo} — afin que la réponse puisse cibler le bon site.
Que dois-je faire si quelque chose ne fonctionne pas ?#
Envoyez un e-mail à support@docsbook.io en indiquant trois éléments : l’URL de la page, ce à quoi vous vous attendiez et ce qui s’est passé à la place. Une capture d’écran est utile ; le SHA du commit l’est encore plus si le problème concerne du contenu qui ne s’est pas affiché.
Où puis-je voir les mises à jour du produit Docsbook ?#
Le journal des modifications répertorie chaque changement déployé et ce qu’il était censé apporter. Les annonces plus courtes sont publiées sur twitter.com/docsbook.
Avec quelles technologies Docsbook est-il développé ?#
Next.js 16, React 19, TypeScript et Tailwind CSS sur Vercel, avec Postgres (Neon) et Redis en arrière-plan, Drizzle comme ORM, Paddle pour la facturation et l’API GitHub pour l’accès aux dépôts. Les appels à l’IA passent par OpenRouter ou par votre propre clé de fournisseur.
Où sont stockées les données de Docsbook ?#
Sur l’infrastructure de Vercel et dans Neon Postgres, hébergé aux États-Unis et dans d’autres régions. Le contenu de votre documentation reste lui-même dans votre dépôt GitHub — Docsbook stocke l’index qu’il en crée, et non une seconde copie de votre source de référence.
Quel analyseur Markdown Docsbook utilise-t-il ?#
remark et rehype, via unified, avec la prise en charge de GitHub Flavored Markdown (GFM). La navigation et la résolution des liens utilisent markdown-lsp, l’analyseur de documentation open source de Docsbook, et la coloration syntaxique utilise Shiki.
Y a-t-il des conditions d’utilisation et une politique de confidentialité ?#
Oui : Conditions et Confidentialité. Si un site enfreint les conditions, Docsbook contacte d’abord son propriétaire et lui donne généralement la possibilité de résoudre le problème avant toute autre mesure.
Articles connexes#
- Tarification — ce qui est mesuré et ce que le solde d’un projet permet de payer
- Démarrage rapide — publier un site de documentation, de la source à l’URL publique
- Concepts — chaque terme utilisé ci-dessus, défini une fois pour toutes
- Cas d’utilisation — les tâches pour lesquelles les équipes font appel à la documentation
Générez un brouillon à partir de votre propre dépôt ou site web et évaluez le résultat avant de vous connecter.