GitBook est l’une des plateformes de documentation les plus populaires parmi les équipes de développeurs. Son éditeur est soigné, ses fonctionnalités de collaboration solides, et ses docs publiées ont fière allure. Si vous évaluez des outils de documentation, il figure probablement sur votre liste.

Nous avons créé Valoryx pour résoudre des problèmes que GitBook n’adresse pas — principalement autour de la propriété git, de l’auto-hébergement et de la transparence tarifaire. Mais nous voulons vous offrir une comparaison honnête, pas une page marketing. Voici où chaque outil brille et où chacun montre ses limites.

Expérience de l’éditeur

GitBook dispose d’un excellent éditeur web. Basé sur des blocs, propre, responsive. Il prend en charge les raccourcis markdown, les blocs de code, les tableaux et les intégrations. Les fonctionnalités de collaboration (commentaires, demandes de modification) sont bien conçues. Pour les membres non techniques d’une équipe qui doivent contribuer aux docs, l’éditeur de GitBook est difficile à surpasser.

Valoryx utilise un éditeur WYSIWYG basé sur Tiptap qui produit du markdown propre. Il prend en charge les raccourcis markdown, les blocs de code avec coloration syntaxique, les tableaux, les encadrés et les intégrations d’images. L’éditeur est optimisé pour la vitesse — aucune latence perceptible même sur de grands documents. La collaboration inclut les commentaires en ligne et les versions nommées de documents.

Verdict : L’éditeur de GitBook est plus mature aujourd’hui, notamment pour les workflows de collaboration en équipe. L’éditeur de Valoryx est plus rapide et produit du markdown plus propre, ce qui importe si vous éditez aussi les docs dans un IDE.

Intégration git

C’est là que les produits divergent le plus.

GitBook propose la « Git Sync » avec GitHub et GitLab. Les modifications effectuées dans l’interface GitBook créent des commits dans votre dépôt. Cependant, la synchronisation n’est pas véritablement bidirectionnelle — pousser des modifications depuis un IDE vers git provoque fréquemment des conflits de fusion qui nécessitent une résolution manuelle dans l’interface de GitBook. Le dépôt git n’est pas la source de vérité ; c’est le stockage interne de GitBook. Si vous déconnectez Git Sync, votre contenu continue d’exister dans GitBook mais l’historique git se retrouve orphelin.

Valoryx est construit sur git depuis ses fondations. Votre documentation est un dépôt git — c’est le seul stockage. L’éditeur web crée des commits, et les git push mettent à jour l’interface web. Il n’existe pas de stockage interne séparé susceptible de diverger. Le pattern Content Ledger garantit que les modifications simultanées depuis l’interface web et git ne génèrent jamais de conflits.

Verdict : Si l’intégration git est importante pour votre workflow — et particulièrement si les développeurs éditent les docs en parallèle du code dans leur IDE — Valoryx est nettement supérieur. Si votre équipe édite uniquement dans l’interface web et traite git comme une sauvegarde, la synchronisation de GitBook est suffisante.

Auto-hébergement

GitBook est uniquement en cloud. Il n’existe pas d’option auto-hébergée. Le contenu de votre documentation est stocké sur les serveurs de GitBook. Pour les équipes ayant des exigences de résidence des données, des contraintes de conformité, ou simplement une préférence pour contrôler leur infrastructure, c’est éliminatoire.

Valoryx est un binaire Go unique sans dépendance externe. Téléchargez, exécutez, c’est terminé. Il fonctionne sur Linux, macOS, Windows et Docker. Toutes les données restent sur votre serveur. Il n’y a pas de télémétrie, pas de validation de clé de licence, pas de fonctionnalités conditionnées par le plan. L’édition Community (gratuite, jusqu’à 5 éditeurs) dispose des mêmes fonctionnalités que les éditions auto-hébergées Équipe et Business.

Verdict : Si vous avez besoin d’auto-hébergement, Valoryx est la seule option ici. GitBook ne le propose pas.

Tarification

GitBook offre un niveau gratuit pour un usage personnel et les projets open-source. Le plan Équipe commence à 6,70 $/utilisateur/mois (facturé annuellement) avec un minimum de 5 utilisateurs. Le plan Business est sur devis. Des fonctionnalités comme le SSO, les journaux d’audit et les permissions avancées sont réservées aux niveaux supérieurs.

Valoryx propose trois niveaux :

  • Community (gratuit à vie) : Auto-hébergé, jusqu’à 5 éditeurs, fonctionnalités complètes incluant la sync git, l’éditeur WYSIWYG, les docs publiées et la recherche plein texte.
  • Équipe (29 $/espace de travail/mois) : Hébergement cloud géré, éditeurs illimités, domaines personnalisés, support prioritaire.
  • Business (79 $/espace de travail/mois) : SSO/SAML, journaux d’audit, infrastructure dédiée, SLA.

Verdict : Pour les petites équipes (5 personnes ou moins), Valoryx est imbattable — l’édition auto-hébergée gratuite n’a aucune restriction de fonctionnalités. Le niveau gratuit de GitBook est limité à un usage personnel ou open-source. Pour les équipes plus grandes, la tarification par utilisateur de GitBook peut augmenter rapidement ; la tarification par espace de travail de Valoryx est plus simple et souvent moins chère.

Sites de documentation publiés

GitBook génère des sites de documentation propres et professionnels avec des domaines personnalisés, du versionnage et une recherche. Le rendu publié est soigné et facile à naviguer. Le SEO est bien géré.

Valoryx génère également des sites de documentation publiés avec des domaines personnalisés, du versionnage, une recherche plein texte et plusieurs thèmes. Le rendu publié est généré statiquement pour un chargement rapide. Les balises meta SEO, les sitemaps et les données structurées sont inclus automatiquement.

Verdict : Les deux produisent des docs publiées de qualité. GitBook offre plus de finition visuelle aujourd’hui ; Valoryx se concentre sur la performance (génération statique) et la qualité de la recherche (SQLite FTS5).

Quand choisir GitBook

  • Votre équipe édite les docs exclusivement dans une interface web (pas d’édition en IDE)
  • Vous avez besoin de fonctionnalités de collaboration matures (commentaires, demandes de modification) dès maintenant
  • Vous n’avez pas besoin d’auto-hébergement
  • Vous préférez un produit établi et soigné avec une large base d’utilisateurs

Quand choisir Valoryx

  • La propriété git est importante — vous voulez vos docs dans un vrai dépôt git, en permanence
  • Les développeurs éditent les docs en parallèle du code dans leur IDE
  • Vous avez besoin d’auto-hébergement pour la conformité, la résidence des données ou par préférence
  • Vous voulez une plateforme de documentation gratuite et complète pour les petites équipes
  • Vous valorisez la simplicité — un seul binaire, zéro dépendance, installation en 30 secondes

La vérité honnête

GitBook est un bon produit pour les équipes qui vivent dans le navigateur. Valoryx est un meilleur produit pour les équipes qui vivent dans git. Nous avons créé Valoryx parce que nous sommes ce deuxième type d’équipe, et nous ne trouvions pas d’outil qui traitait git comme un citoyen de première classe plutôt que comme une intégration ajoutée après coup.

Les deux outils vous aideront à créer et publier de la documentation. La question est de savoir où vit votre source de vérité — et qui la contrôle.