https://valoryx.org/fr/ Recent content in Valoryx — Plateforme de Documentation Git-Native on Valoryx Hugo fr Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/fr/docs/getting-started/quickstart/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/getting-started/quickstart/ Démarrage rapide Passez de zéro à une plateforme de documentation fonctionnelle en moins de 5 minutes. Ce guide couvre le chemin le plus rapide — pour les options détaillées, consultez le guide d’Installation. Étape 1 : Installer # Recommandé (détection automatique de la plateforme) curl -fsSL https://valoryx.org/install.sh | sh Ou télécharger manuellement : curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform Ou avec Docker : docker run -d --name docplatform -p 3000:3000 -v docplatform-data:/data ghcr. https://valoryx.org/fr/docs/deployment/binary/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/deployment/binary/ Déploiement binaire La méthode de déploiement la plus simple — téléchargez un binaire unique, exécutez-le sur votre serveur. Pas de dépendances d’exécution, pas de conteneurs, pas d’orchestrateur. Téléchargement Obtenez la dernière version pour votre plateforme : # Recommandé (détection automatique de la plateforme) curl -fsSL https://valoryx.org/install.sh | sh # Ou téléchargement manuel d'un binaire spécifique à la plateforme curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Ou téléchargement d'une version spécifique curl -sLO https://github. https://valoryx.org/fr/docs/guides/editor/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/editor/ L’éditeur web DocPlatform inclut un éditeur de texte riche basé sur Tiptap (fondé sur ProseMirror) qui affiche le Markdown en temps réel tout en préservant une compatibilité totale avec le format Markdown source. Chaque modification que vous effectuez produit un fichier .md propre — pas de format propriétaire, pas de verrouillage. Disposition de l’éditeur ┌─────────────────────────────────────────────────────────────┐ │ Sidebar │ Editor │ │ │ │ │ 📁 Getting │ ┌──────────────────────────────────┐ │ │ Started │ │ Frontmatter (collapsible) │ │ │ 📁 Guides │ │ Title: ___________________ │ │ │ 📁 API │ │ Description: ______________ │ │ │ > auth. https://valoryx.org/fr/cloud/guides/writing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/cloud/guides/writing/ Redaction et edition Valoryx Cloud vous offre un editeur epure et sans distraction qui fonctionne comme Google Docs — mais stocke tout en Markdown pour une portabilite maximale. Creer une page Ouvrez votre espace de travail depuis le tableau de bord Cliquez sur + New Page dans la barre laterale Saisissez un titre et commencez a ecrire Les pages sont enregistrees automatiquement au fil de la saisie. Chaque sauvegarde cree une version dans l’historique de votre espace de travail, ce qui vous permet de revenir en arriere a tout moment. https://valoryx.org/fr/docs/reference/api/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/reference/api/ Référence de l’API REST DocPlatform expose une API JSON RESTful à /api/v1/. Tous les endpoints nécessitent une authentification sauf indication contraire. URL de base http://localhost:3000/api/v1 Authentification La plupart des endpoints nécessitent un token d’accès JWT dans l’en-tête Authorization : Authorization: Bearer eyJhbGciOiJSUzI1NiIs... Obtenez des tokens via les endpoints de connexion ou OIDC. Cycle de vie des tokens Token Durée de vie Objectif Token d’accès 15 minutes Authentification API Token de rafraîchissement 30 jours Obtenir de nouveaux tokens d’accès Endpoints d’authentification Inscription POST /api/v1/auth/register Créer un nouveau compte utilisateur. https://valoryx.org/fr/docs/configuration/environment/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/configuration/environment/ Variables d’environnement DocPlatform lit sa configuration depuis les variables d’environnement. Définissez-les dans votre shell, un fichier .env dans le répertoire de travail ou votre orchestrateur de conteneurs. Serveur Variable Par défaut Description PORT 3000 Port d’écoute HTTP HOST 0.0.0.0 Adresse d’écoute HTTP. Définissez à 127.0.0.1 pour restreindre à localhost. DATA_DIR .docplatform Répertoire racine pour toutes les données DocPlatform (base de données, sauvegardes, espaces de travail, clés) BASE_DOMAIN — Domaine personnalisé pour la documentation publiée (par ex. https://valoryx.org/fr/docs/configuration/authentication/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/configuration/authentication/ Authentification DocPlatform prend en charge l’authentification locale (e-mail + mot de passe) par défaut, avec la connexion OIDC Google et GitHub optionnelle pour les équipes utilisant ces fournisseurs. Authentification locale (par défaut) L’authentification locale fonctionne sans aucune configuration. Les utilisateurs s’inscrivent avec un e-mail et un mot de passe, et se connectent avec les mêmes identifiants. Fonctionnement Inscription — L’utilisateur soumet e-mail + mot de passe. Le mot de passe est haché avec argon2id (algorithme recommandé par l’OWASP 2024). https://valoryx.org/fr/docs/deployment/docker/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/deployment/docker/ Déploiement Docker DocPlatform est distribué sous forme d’image Docker multi-architecture (amd64/arm64) construite sur Alpine Linux. Démarrage rapide docker run -d \ --name docplatform \ -p 3000:3000 \ -v docplatform-data:/data \ ghcr.io/valoryx-org/docplatform:latest Ouvrez http://localhost:3000 et enregistrez votre compte administrateur. Premier lancement Au premier démarrage, DocPlatform effectue automatiquement : Création de la base de données SQLite dans /data/data.db Génération d’une clé de signature RS256 dans /data/jwt-key.pem Initialisation de l’index de recherche plein texte Début de l’écoute sur le port 3000 Le premier utilisateur à s’inscrire devient le Super Admin avec un accès complet à la plateforme. https://valoryx.org/fr/docs/getting-started/installation/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/getting-started/installation/ Installation DocPlatform est distribué sous forme de binaire unique sans aucune dépendance d’exécution. Choisissez la méthode d’installation qui convient à votre workflow. Option 1 : Binaire pré-compilé (recommandé) Téléchargez la dernière version pour votre plateforme. Linux / macOS # Recommandé (détection automatique de la plateforme) curl -fsSL https://valoryx.org/install.sh | sh # Ou téléchargement manuel curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Vérifier l'installation docplatform version Sortie attendue : https://valoryx.org/fr/docs/guides/markdown/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/markdown/ Markdown et composants DocPlatform utilise du Markdown conforme à CommonMark avec un frontmatter YAML et 7 composants personnalisés pour une documentation riche et interactive. Bases du Markdown DocPlatform prend en charge la spécification CommonMark complète ainsi que des extensions courantes. Titres # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 Les titres génèrent automatiquement des identifiants d’ancrage pour les liens profonds : ## My Section → #my-section. https://valoryx.org/fr/cloud/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/cloud/guides/publishing/ Publier votre documentation Transformez n’importe quel espace de travail en un site de documentation public et soigne. Vos lecteurs beneficient d’une experience rapide, avec recherche integree et adaptee aux mobiles — et vous obtenez un site qui se met a jour a chaque sauvegarde. Comment publier Allez dans Workspace Settings → Published Docs Activez Enable publishing Vos documents sont immediatement en ligne a l’adresse app.valoryx.dev/p/your-workspace-slug/ C’est tout. Chaque page de votre espace de travail est desormais accessible publiquement. https://valoryx.org/fr/docs/reference/cli/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/reference/cli/ Référence CLI DocPlatform fournit 5 commandes CLI pour la gestion du serveur, l’initialisation des espaces de travail, les diagnostics et la maintenance. Options globales Ces options s’appliquent à toutes les commandes : Flag Description --help, -h Afficher l’aide pour n’importe quelle commande --version, -v Afficher les informations de version docplatform serve Démarrer le serveur HTTP. docplatform serve [flags] Flags Flag Par défaut Description --port 3000 Port d’écoute HTTP (supplante la variable d’environnement PORT) --host 0. https://valoryx.org/fr/docs/deployment/production/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/deployment/production/ Checklist de production Utilisez cette checklist avant de déployer DocPlatform dans un environnement de production. Chaque élément renvoie vers la section de documentation correspondante. Requis Ces éléments sont nécessaires pour un déploiement en production sécurisé et fiable. Serveur Stockage persistant configuré — Montez un volume ou utilisez un chemin de système de fichiers stable pour DATA_DIR. La perte de ce répertoire signifie la perte de toutes les données. Gestionnaire de processus en place — Utilisez systemd, Docker avec restart: unless-stopped ou un orchestrateur de conteneurs pour garantir le redémarrage du serveur après un crash ou un redémarrage. https://valoryx.org/fr/cloud/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/cloud/guides/collaboration/ Collaboration en equipe Valoryx Cloud est concu pour le travail en equipe. Invitez vos collegues, controlez qui peut modifier quoi et suivez les changements en temps reel. Inviter des collaborateurs Allez dans Workspace Settings → Members Saisissez leur adresse e-mail Choisissez un role (voir ci-dessous) Cliquez sur Send Invitation Ils recevront un e-mail contenant un lien pour rejoindre l’espace. S’ils n’ont pas encore de compte Valoryx, ils seront invites a en creer un. https://valoryx.org/fr/docs/reference/troubleshooting/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/reference/troubleshooting/ Dépannage Ce guide couvre les problèmes courants et leurs solutions. Pour des informations diagnostiques, commencez toujours par : docplatform doctor Démarrage du serveur Le serveur ne démarre pas : « address already in use » Cause : Un autre processus utilise le port configuré. Solution : # Trouver ce qui utilise le port 3000 lsof -i :3000 # macOS/Linux ss -tlnp | grep 3000 # Linux # Option 1 : Arrêter l'autre processus # Option 2 : Utiliser un port différent docplatform serve --port 8080 Le serveur ne démarre pas : « permission denied » Cause : Le processus n’a pas les droits de lecture/écriture sur le répertoire de données. https://valoryx.org/fr/docs/guides/git-integration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/git-integration/ Intégration Git La synchronisation git bidirectionnelle de DocPlatform permet à votre équipe de travailler comme elle le préfère. Les rédacteurs techniques utilisent l’éditeur web. Les développeurs poussent depuis leur IDE. Tout le monde voit le même contenu. Fonctionnement ┌─────────────┐ │ Web Editor │ │ (browser) │ └──────┬───────┘ │ save ▼ ┌─────────────┐ ┌──────────────┐ │ Content │ commit │ Local Git │ push ┌──────────────┐ │ Ledger │ ───────► │ Repository │ ───────► │ Remote Repo │ │ │ │ (. https://valoryx.org/fr/docs/configuration/permissions/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/configuration/permissions/ Rôles et permissions DocPlatform utilise un contrôle d’accès basé sur les rôles (RBAC) alimenté par un RBAC personnalisé, un moteur d’autorisation in-process. Les permissions sont évaluées en moins de 0,1 ms par vérification, sans aucun service externe. Hiérarchie des rôles DocPlatform définit 5 rôles publics dans une hiérarchie stricte. Les rôles supérieurs héritent de toutes les permissions des rôles inférieurs. Super Admin ← Propriétaire de l'org / créateur du compte (rôle public le plus élevé) │ Admin ← Gérer les paramètres de l'espace de travail, membres, git, thème │ Editor ← Créer et modifier des pages (configurable par workspace) │ Commenter ← Consulter les pages, laisser des commentaires │ Viewer ← Consulter les pages uniquement Platform Owner est un rôle interne réservé aux opérateurs auto-hébergés pour la maintenance de la plateforme (migrations de base de données, gestion des licences, configuration système). https://valoryx.org/fr/docs/getting-started/first-workspace/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/getting-started/first-workspace/ Votre premier espace de travail Un espace de travail est le conteneur principal d’un projet de documentation. Chaque espace de travail correspond à un répertoire de fichiers Markdown et se synchronise optionnellement avec un dépôt git. Concepts de l’espace de travail Concept Description Workspace Un projet de documentation contenant des pages, des membres et des paramètres Page Un fichier Markdown avec un frontmatter YAML (titre, description, tags, accès) Slug L’identifiant compatible URL de votre espace de travail (ex. https://valoryx.org/fr/docs/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/collaboration/ Équipes et collaboration DocPlatform est conçu pour la documentation en équipe. Invitez des membres, attribuez des rôles granulaires et suivez chaque modification grâce à un journal d’audit complet. Appartenance à l’espace de travail Chaque utilisateur appartient à un ou plusieurs espaces de travail avec un rôle spécifique. Les rôles déterminent les actions qu’un utilisateur peut effectuer. Inviter des membres Via l’interface web : Ouvrez Workspace Settings → Members Cliquez sur Invite Member Saisissez l’adresse e-mail de la personne Sélectionnez un rôle Cliquez sur Send Si SMTP est configuré, un e-mail d’invitation est envoyé avec un lien unique. https://valoryx.org/fr/docs/configuration/workspace-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/configuration/workspace-config/ Paramètres de l’espace de travail Chaque espace de travail a son propre fichier de configuration dans .docplatform/workspaces/{workspace-id}/.docplatform/config.yaml. Modifiez ce fichier directement ou utilisez l’interface web (Settings → Workspace). Référence complète de la configuration # Workspace identity workspace_id: 01KJJ10NTF31Z1QJTG4ZRQZ2Z2 # Auto-generated ULID name: "Engineering Docs" # Display name slug: eng-docs # URL slug for published docs description: "Internal engineering documentation" # Git synchronization git_remote: git@github.com:your-org/eng-docs.git git_branch: main git_auto_commit: true # Auto-commit editor saves to git sync_interval: 300 # Polling interval in seconds (0 = disabled) # Theme theme: mode: auto # light, dark, auto (follows system preference) accent: blue # Accent color for published site # Publishing defaults publishing: default_published: false # New pages published by default? https://valoryx.org/fr/cloud/guides/git-sync/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/cloud/guides/git-sync/ Synchronisation GitHub Valoryx Cloud peut synchroniser votre documentation avec un depot GitHub. Vous profitez ainsi du meilleur des deux mondes : un editeur web elegant ET toute la puissance de git. Pourquoi connecter GitHub ? Sauvegarde — vos documents sont toujours en securite sur GitHub, meme si vous resiliez votre compte Edition dans l’IDE — les developpeurs de votre equipe peuvent modifier les documents dans VS Code, Vim ou tout autre editeur Pull requests — utilisez le workflow de PR de GitHub pour relire les documents avant publication Historique des versions — git blame, diff et rollback complets pour chaque modification Integration CI/CD — declenchez des builds ou des tests lorsque la documentation change Comment ca fonctionne Vous editez dans le navigateur → sauvegarde auto → commit auto → push vers GitHub ↕ Un collegue pousse depuis son IDE → GitHub → webhook → pull vers Valoryx Les modifications circulent dans les deux sens automatiquement. https://valoryx.org/fr/cloud/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/cloud/guides/mcp/ IA et integration MCP Valoryx Cloud inclut un serveur MCP (Model Context Protocol) integre qui permet aux assistants IA d’interagir directement avec votre documentation. Qu’est-ce que MCP ? MCP est un protocole standard qui permet aux outils IA de se connecter a des services externes. Voyez-le comme un moyen de donner a Claude ou Cursor la capacite de “voir” vos documents et d’y apporter des modifications — avec votre autorisation. https://valoryx.org/fr/docs/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/publishing/ Publier la documentation DocPlatform peut servir votre documentation sous forme de site web public — avec une barre de navigation latérale, la coloration syntaxique et les métadonnées SEO. Aucun générateur de site statique séparé n’est nécessaire. Fonctionnement de la publication La documentation publiée est servie à /p/{workspace-slug}/{page-path} : http://localhost:3000/p/my-docs/ → docs/index.md http://localhost:3000/p/my-docs/quickstart → docs/quickstart.md http://localhost:3000/p/my-docs/api/auth → docs/api/auth.md Les pages sont rendues du Markdown vers le HTML à la demande en utilisant goldmark (conforme à CommonMark) avec la coloration syntaxique Chroma pour les blocs de code. https://valoryx.org/fr/docs/guides/search/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/search/ Recherche DocPlatform inclut un moteur de recherche plein texte intégré (Bleve) qui indexe automatiquement tout le contenu. Aucun service externe à configurer — la recherche fonctionne directement. Utiliser la recherche Boîte de dialogue Cmd+K Appuyez sur Cmd+K (macOS) ou Ctrl+K (Windows/Linux) n’importe où dans l’éditeur web pour ouvrir la boîte de recherche. ┌──────────────────────────────────────────┐ │ 🔍 Search documentation... │ ├──────────────────────────────────────────┤ │ │ │ 📄 Getting Started │ │ Install and configure DocPlatform. https://valoryx.org/fr/cloud/guides/account/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/cloud/guides/account/ Votre compte Inscription Rendez-vous sur app.valoryx.dev et creez un compte avec votre adresse e-mail et un mot de passe. Vous devrez accepter les Conditions d’utilisation et la Politique de confidentialite. Vous pouvez egalement vous connecter avec Google ou GitHub si ces options sont disponibles. Parametres du profil Cliquez sur votre avatar en haut a gauche, puis Profile pour : Modifier votre nom d’affichage Mettre a jour votre adresse e-mail Changer votre mot de passe Configurer une passkey (WebAuthn) pour la connexion sans mot de passe Facturation Allez dans Workspace Settings → Billing pour : https://valoryx.org/fr/docs/guides/ai-features/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/ai-features/ AI Features DocPlatform includes built-in AI capabilities powered by Claude (Anthropic) or OpenAI. These features help you write, improve, and explore your documentation faster. Setup Enable AI features by setting your provider and API key: # .env AI_PROVIDER=anthropic # or "openai" AI_API_KEY=sk-ant-... # your API key AI_MODEL= # optional — uses provider default if empty Restart the server. AI features appear in the editor toolbar and are accessible via the API. https://valoryx.org/fr/docs/guides/analytics/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/analytics/ Analytics DocPlatform includes built-in analytics for tracking how your documentation is used. No third-party tracking scripts or external services required. How it works Analytics data is collected in a separate analytics.db SQLite database (not in the main database). This separation ensures analytics never impact content performance. What is tracked Data point Description Page path Which page was viewed Referrer Where the visitor came from Timestamp When the page was viewed Search queries What users searched for What is NOT tracked IP addresses (never stored) User agents are not stored Cookies or cross-session identifiers (without consent) Personally identifiable information GDPR compliance Analytics requires explicit cookie consent from visitors. https://valoryx.org/fr/docs/guides/billing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/billing/ Billing & Plans DocPlatform uses Stripe for subscription billing. Three plan tiers are available, each with different limits and features. Plans Feature Community (Free) Free Team ($29/mo) Business ($79/mo) Editors Unlimited 3 15 50 Workspaces Unlimited 1 3 10 Viewers / Commenters Unlimited Unlimited Unlimited Unlimited Pages Unlimited 50 150 500 Published docs Unlimited Unlimited Unlimited Unlimited Analytics — — Included Included Custom domains — — Included Included Advanced AI — — Included Included Priority support — — — Included Annual pricing Annual subscriptions include 2 months free: https://valoryx.org/fr/docs/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/docs/guides/mcp/ MCP Server — AI Integration Guide DocPlatform includes a built-in Model Context Protocol (MCP) server that lets AI assistants read, write, search, and manage your documentation directly. Instead of copy-pasting content into chat windows, your AI tools work with your docs natively. Prerequisites DocPlatform running (binary, Docker, or Fly.io) An API key (create one in Workspace Settings → API Keys) Quick start 1. Create an API key In your DocPlatform instance, go to Workspace Settings → API Keys → Create Key. https://valoryx.org/fr/changelog/v0.11.1/ Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/fr/changelog/v0.11.1/ Cette entrée consolide tout ce qui a été livré entre v0.6.4 et v0.11.1. Le détail complet par version est fourni avec le changelog de la documentation produit. Serveur MCP : 26 outils Le serveur MCP intégré est passé de 13 à 26 outils — CRUD de contenu, recherche, lots de contexte RAG, analyse de qualité, versionnage, export, assistance à la rédaction par IA, commentaires, activité, publication d’espaces de travail et résolution de conflits de synchronisation git. https://valoryx.org/fr/blog/ai-native-documentation/ Mon, 13 Apr 2026 00:00:00 +0000 https://valoryx.org/fr/blog/ai-native-documentation/ La documentation a un problème de maintenance. Vous écrivez un guide, le publiez, et en trois mois il est obsolète. L’API a changé. Le format de configuration a été remanié. Une dépendance a été remplacée. Les captures d’écran montrent une interface qui n’existe plus. La solution n’est pas « écrire de meilleure documentation » ou « créer une culture de la documentation ». Les équipes essaient ça depuis des décennies. La solution est de rendre la documentation consciente du code qu’elle décrit — pour que quand le code change, la documentation le sache. https://valoryx.org/fr/blog/documentation-platform-cost/ Thu, 09 Apr 2026 00:00:00 +0000 https://valoryx.org/fr/blog/documentation-platform-cost/ La tarification par utilisateur semble raisonnable à première vue. Cinq utilisateurs à 8 $/mois ? C’est 40 $. Votre équipe peut se permettre 40 $. Mais la documentation est l’un de ces outils où le nombre de personnes qui devraient avoir accès ne cesse de croître. Les ingénieurs doivent écrire. Les product managers doivent relire. Le support doit consulter. Les nouveaux arrivants doivent lire et annoter. Soudain vous n’êtes plus à 5 postes — vous êtes à 50, et ces 8 $/poste « abordables » représentent 400 $/mois pour un outil qui stocke des fichiers texte. https://valoryx.org/fr/blog/docs-for-open-source/ Mon, 06 Apr 2026 00:00:00 +0000 https://valoryx.org/fr/blog/docs-for-open-source/ Les projets open source vivent ou meurent par leur documentation. Une bibliothèque avec une bonne documentation est adoptée. Une bibliothèque avec un simple README et une attitude « lisez le code » est forkée par quelqu’un qui écrit une meilleure documentation — ou tout simplement ignorée. Mais la plupart des outils de documentation sont conçus pour des entreprises, pas pour des mainteneurs OSS. Ils facturent par utilisateur, par page ou par workspace. https://valoryx.org/fr/blog/documentation-search-works/ Thu, 02 Apr 2026 00:00:00 +0000 https://valoryx.org/fr/blog/documentation-search-works/ Vous tapez une requête dans la barre de recherche de votre documentation. Des résultats apparaissent. Mais que s’est-il passé entre la frappe et les résultats ? Pour la plupart des plateformes de documentation, la réponse est soit « pas grand-chose » (correspondance basique par mots-clés qui manque des résultats évidents) soit « beaucoup d’infrastructure » (un cluster Elasticsearch que votre équipe ops doit maintenir). Il existe un juste milieu que la plupart des équipes ignorent : la recherche plein texte embarquée. https://valoryx.org/fr/blog/single-binary-architecture/ Mon, 30 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/single-binary-architecture/ La plupart des plateformes de documentation sont livrées sous forme de stack. Vous obtenez une application Node.js, une base de données PostgreSQL, un cache Redis, un cluster Elasticsearch pour la recherche et un reverse proxy Nginx pour lier le tout. Cinq services, cinq choses qui peuvent casser, cinq choses à surveiller, patcher et mettre à jour. DocPlatform est livré sous forme d’un seul fichier. Téléchargez-le, lancez-le, c’est fait. Ce n’est pas un artifice marketing. https://valoryx.org/fr/blog/keep-docs-up-to-date/ Thu, 26 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/keep-docs-up-to-date/ Chaque équipe d’ingénierie a le même problème de documentation. Quelqu’un rédige une documentation complète lors d’un lancement. Six mois plus tard, l’API a changé, le format de configuration est différent, et trois pages référencent une fonctionnalité qui a été renommée. Personne n’a mis à jour la documentation parce que mettre à jour la documentation est une tâche séparée de l’écriture du code, et les tâches séparées sont oubliées. Le conseil habituel — « faites de la documentation une partie de votre culture » — ne fonctionne pas. https://valoryx.org/fr/blog/docs-regulated-industries/ Mon, 23 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/docs-regulated-industries/ Si vous travaillez dans la santé, la défense, la finance ou tout secteur où la résidence des données compte, vous avez déjà eu la conversation : « Peut-on utiliser cet outil SaaS, ou doit-il passer par une évaluation de sécurité de six mois ? » Pour la plupart des plateformes de documentation cloud, la réponse est l’évaluation — et elle se termine souvent par « non ». Le problème n’est pas que les outils cloud sont insécurisés. https://valoryx.org/fr/blog/bidirectional-git-sync/ Thu, 19 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/bidirectional-git-sync/ Chaque plateforme de documentation avec une page d’intégration git fait la même promesse : votre documentation vit dans git, votre équipe édite dans le navigateur, et tout reste synchronisé. En pratique, la plupart de ces intégrations sont des miroirs unidirectionnels qui se cassent dès que deux personnes éditent depuis des directions différentes. Nous avons écrit sur pourquoi cela arrive dans un article précédent. Celui-ci approfondit la solution : comment Valoryx implémente la synchronisation bidirectionnelle en utilisant le pattern Content Ledger, et pourquoi cette approche gère les scénarios qui cassent les autres outils. https://valoryx.org/fr/blog/mcp-documentation-guide/ Mon, 16 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/mcp-documentation-guide/ Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA d’interagir avec des outils externes et des sources de données via une interface structurée. Au lieu de copier du texte dans une fenêtre de chat en espérant que le modèle comprenne le contexte, MCP donne à l’assistant un accès direct et typé à vos systèmes — lire des fichiers, lancer des recherches, créer du contenu, le tout via des appels d’outils bien définis. https://valoryx.org/fr/blog/internal-docs-developers-use/ Thu, 12 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/internal-docs-developers-use/ Chaque organisation d’ingénierie dispose de documentation interne. Et dans la plupart d’entre elles, cette documentation est incomplète, obsolète ou ignorée. Selon le sondage Stack Overflow des développeurs 2024, une majorité de développeurs considèrent la documentation insuffisante ou manquante comme un obstacle significatif à leur productivité. Ce n’est pas un problème de discipline. C’est un problème d’outillage. La documentation interne échoue pour des raisons spécifiques et réparables. Les outils rendent la rédaction pénible. https://valoryx.org/fr/blog/docs-should-be-in-git/ Mon, 09 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/docs-should-be-in-git/ Voici un inventaire de ce qu’une équipe d’ingénierie typique conserve dans git : Code source de l’application Définitions d’infrastructure (Terraform, Pulumi, CloudFormation) Configurations de pipelines CI/CD Scripts de migration de base de données Spécifications API (OpenAPI, protobuf) Manifestes de déploiement (Kubernetes, Docker Compose) Templates de configuration d’environnement Et voici ce qui vit habituellement en dehors de git : La documentation C’est étrange. La documentation décrit le système. Elle change quand le système change. https://valoryx.org/fr/changelog/v0.5.2/ Sat, 07 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/changelog/v0.5.2/ Intégration de la facturation La facturation propulsée par Stripe est désormais intégrée. Configurez vos offres, gérez les abonnements et traitez les mises à niveau directement depuis le tableau de bord d’administration. Intégration des webhooks Stripe avec 5 types d’événements Gestion du cycle de vie des abonnements (création, mise à niveau, annulation) Comptage basé sur l’utilisation pour les appels API et le stockage Génération de factures et historique des paiements Limites d’offre configurables par espace de travail Tableau de bord analytique Suivez les performances de votre documentation grâce au nouveau tableau de bord analytique. https://valoryx.org/fr/blog/documentation-as-code/ Thu, 05 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/documentation-as-code/ « Documentation as code » est une expression que l’on entend souvent. Dans sa forme la plus simple, cela signifie traiter la documentation de la même manière que le code source : stockée dans un système de contrôle de versions, écrite en texte brut, révisée via des pull requests, et construite via CI/CD. Mais il y a un écart entre l’idée et sa mise en œuvre réussie. Ce guide couvre ce qu’est docs-as-code, quelles approches existent, et où chacune atteint ses limites. https://valoryx.org/fr/blog/self-host-docs-5-minutes/ Mon, 02 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/self-host-docs-5-minutes/ La plupart des outils de documentation auto-hébergés nécessitent une base de données, un reverse proxy et une demi-après-midi d’édition de YAML avant de voir un écran d’accueil. DocPlatform est un binaire Go unique sans aucune dépendance externe. Ce tutoriel vous emmène de zéro à une documentation publiée en environ cinq minutes. Prérequis Vous avez besoin d’une machine Linux, macOS ou Windows. C’est tout. Pas de Docker, pas de PostgreSQL, pas de runtime Node. https://valoryx.org/fr/blog/notion-alternative-self-hosted/ Sun, 01 Mar 2026 00:00:00 +0000 https://valoryx.org/fr/blog/notion-alternative-self-hosted/ Notion est partout. Les équipes design l’utilisent pour leurs briefs. Les équipes produit l’utilisent pour leurs roadmaps. Les équipes marketing l’utilisent pour leurs calendriers éditoriaux. Et de plus en plus, les équipes d’ingénierie l’utilisent pour la documentation — specs techniques, runbooks, guides d’intégration, références API. Ça fonctionne, jusqu’à un certain point. Puis vous atteignez les limites, et ces limites sont tranchantes. Cet article s’adresse aux équipes qui ont atteint ces limites et cherchent quelque chose de mieux — spécifiquement pour la documentation technique qui a sa place dans un dépôt git, pas dans une base de données propriétaire. https://valoryx.org/fr/blog/self-hosted-docs-guide/ Fri, 27 Feb 2026 00:00:00 +0000 https://valoryx.org/fr/blog/self-hosted-docs-guide/ La documentation auto-hébergée connaît un véritable essor. Après des années de hausse de prix, de changements de conditions d’utilisation et de fermetures inopinées de plateformes SaaS, de plus en plus d’équipes choisissent de gérer leur propre infrastructure de documentation. Les raisons sont simples : propriété des données, maîtrise des coûts, conformité réglementaire, et la tranquillité d’esprit de savoir que votre base de connaissances ne disparaîtra pas quand une startup sera à court de financement. https://valoryx.org/fr/blog/gitbook-vs-valoryx/ Wed, 25 Feb 2026 00:00:00 +0000 https://valoryx.org/fr/blog/gitbook-vs-valoryx/ 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. https://valoryx.org/fr/blog/why-git-sync-breaks/ Sun, 22 Feb 2026 00:00:00 +0000 https://valoryx.org/fr/blog/why-git-sync-breaks/ Si vous maintenez de la documentation technique, vous avez probablement été brûlé par cette promesse : « Intégration git complète. » Vous connectez votre dépôt, faites quelques modifications dans l’interface web, poussez un commit depuis votre IDE — et tout s’effondre. Conflits de fusion. Modifications perdues. Pages qui reviennent silencieusement à leur état précédent. Un statut de synchronisation qui indique « à jour » pendant que votre contenu diverge. Ce n’est pas un bug propre à un produit particulier. https://valoryx.org/fr/vs/gitbook/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/fr/vs/gitbook/