Tout ce qu'il fait,
et tout ce qu'il ne fera pas.
Lecture
- front matter supprimé
- images de badge supprimées
- liens relatifs réécrits depuis la racine du repository
- chemins conservés, pour qu'un modèle puisse les citer
L'arborescence est la navigation
Aucun fichier de configuration, aucun front matter, aucune barre latérale à maintenir. La racine de la documentation est trouvée, les titres viennent du front matter, puis du premier titre, puis du nom de fichier ; l'ordre place le README en premier puis les préfixes numériques, et CHANGELOG et LICENSE se regroupent en bas au lieu d'encombrer le haut.
Le chemin éclairé
Le rail à côté de l'arborescence éclaire l'ascendance de ce que vous lisez, pour que vous sachiez toujours où vous vous trouvez dans le corpus.
Conçu pour être lu de bout en bout
Une mesure de 78 caractères à toutes les largeurs, une vraie typographie, sombre par défaut. Pour une spécification que l'on lit vraiment, pas une page que l'on survole.
Diagrammes et code
Mermaid s'affiche dans la palette du produit, et les blocs de code utilisent six couleurs de syntaxe qui suivent le thème. Ni l'un ni l'autre n'est chargé pour un document qui n'en contient pas.
Vos préférences de lecture
Le thème, la largeur de lecture, la densité de la barre latérale et les animations vous appartiennent et vous suivent, appliqués avant le premier rendu plutôt qu'après.
Copier pour un LLM
Emportez un document ou un dossier entier vers votre modèle en markdown propre — front matter et badges retirés, liens réécrits — avec le nombre de tokens avant de coller.
Sources
Deux fournisseurs, en lecture seule, jamais clonés
Une GitHub App avec un accès en lecture aux repositories que vous choisissez, révocable depuis GitHub à tout moment. Ou un token d'accès GitLab — gitlab.com, instances auto-hébergées ou internes, projets publics et privés. Un seul appel renvoie toute l'arborescence plus un blob SHA par fichier ; aucun binaire git, aucune copie de travail, rien sur disque.
Aucun token dans la base de données
Les tokens d'installation GitHub sont émis à la demande à partir de la clé de l'App et gardés en mémoire uniquement. Un token GitLab est chiffré au repos sous sa propre clé, et celui qui porte une portée d'écriture ou n'a pas d'expiration est refusé nommément à la connexion.
Plusieurs repositories, un seul projet
Un ingénieur qui travaille sur six services les lit et y cherche depuis un seul endroit. Un projet regroupe des repositories et porte la liste d'accès.
Les images privées fonctionnent
Les images d'un repository privé passent par un proxy authentifié au lieu d'être liées directement, si bien qu'elles se chargent pour les personnes autorisées à les voir et pour personne d'autre.
La branch est lue, pas devinée
La vraie liste des branches vient du repository. Un sélecteur figé « main ou master » a un jour fait pointer une connexion vers une branch qui n'existait pas, et la synchronisation n'a alors rien trouvé.
Recherche
Chaque document de chaque repository connecté
Recherche plein texte dans toute l'organisation en une seule requête, classée, avec le chemin et l'état de relecture à côté de chaque résultat. Postgres standard, sans extension — une recherche qui en exige une cesse de fonctionner sur la base managée de quelqu'un.
Une seule touche
La palette de commandes s'ouvre avec ⌘K pour tout et ⌘P pour les fichiers, avec les projets, les réglages et les actions du compte dans la même liste.
Rechercher dans le document
⌘F surligne les correspondances sans toucher au balisage du document, si bien que rien ne bouge sur la page pendant que vous y cherchez.
Workflow
Deux axes, et une dérive mesurée sur le contenu
L'état de relecture et l'état d'implémentation évoluent indépendamment, et chacun retient la version exacte sur laquelle il a été posé. Modifiez le document et il affiche validé · décalé au lieu de garder un badge qui n'est plus vrai. Un document que personne n'a trié n'a aucune ligne — un corpus non trié ne coûte rien et n'affiche aucune pastille.
Le tableau
Chaque document doté d'un statut, dans des colonnes entre lesquelles vous pouvez le glisser, sur un projet ou toute l'organisation, filtré par une URL que vous pouvez envoyer à quelqu'un.
Des notes sur un titre
Un retour ancré à la section qu'il concerne. Une note dont le titre disparaît échoue visiblement au lieu de se déplacer sur un texte qui dit autre chose.
Accusés de lecture
Comptées après dix secondes de lecture visible, jamais sur un clic, et seulement pour la version actuelle — ainsi « trois relecteurs sur cinq l'ont lu » veut dire ce que cela dit.
Marquer un document « Sans objet »
Retirez un README du tableau sans rien dire du document lui-même. Ni brouillon ni rejeté : ce n'est pas un élément de travail, voilà tout.
Le journal des révisions
Les versions passées sont stockées plutôt que récupérées à nouveau, pour que vous voyiez ce qui a changé entre la version que quelqu'un a validée et le texte actuel.
Interroger votre documentation
Des résumés qui savent quand ils sont périmés
Un résumé est indexé sur le contenu du document, pas sur une date : il est à jour ou il dit qu'il ne l'est pas. Une réponse en cache ne dépense aucun crédit, ce qui rend l'allocation tenable. Le texte d'un document ne sort de la machine que pour une organisation qui l'a activé — le réglage est désactivé par défaut et son activation est auditée.
Les questions que le résumé a proposées
Vous posez les questions que suggère le résumé actuel, pas du texte libre. Sans ce garde-fou, n'importe quel membre détient un canal non validé, financé par l'organisation, vers un modèle tiers.
Discuter avec un document
Diffusé en continu, ancré dans un seul document, et séparé du parcours des questions suggérées exactement pour la raison ci-dessus.
Résumés de changement
Un paragraphe sur ce qui a bougé, pour les documents que quelqu'un suit, plutôt qu'un diff à lire.
Résumés par lot
Résumez un corpus délibérément, avec son prix affiché avant l'exécution. Jamais automatique, car une passe en arrière-plan qui consomme une allocation est une facture que personne n'a acceptée.
Agents
Un serveur MCP sur votre propre documentation — 16 outils
Un seul endpoint sans état. Votre agent de code trouve, lit et cite ce que votre équipe a déjà écrit, sans rien coller dans un prompt. Les outils sont retenus par portée plutôt que par nom, si bien qu'une clé en lecture seule ne voit jamais la moitié écriture.
Artifacts
Un agent dépose une spécification ou un plan comme document versionné à côté de la documentation. Il ne peut jamais atteindre un fichier du repository, et il n'y a pas de suppression.
Seuils de relecture
Une clé peut porter un état de relecture minimal. En dessous, les documents répondent 404 à chaque porte — sur les routes du lecteur aussi, car un seuil avec une seule porte d'entrée n'est pas un seuil.
Réponses typées
Un agent répond à une note par d'accord, en désaccord, demande une clarification ou traité. Quatre notes où il était en désaccord forment une file qu'un responsable ouvre ; une transcription, non.
Déclarations d'implémentation
Un agent indique qu'il a commencé ou terminé, avec des preuves enregistrées comme note. Cela consigne une affirmation, jamais un achèvement.
Limites de débit, pas des quotas
Les lectures sont gratuites sur tous les plans et limitées par un token bucket par clé plutôt que par une allocation mensuelle.
Organisations et accès
L'adhésion, c'est l'organisation ; l'accès, c'est le projet
Rejoindre ne donne accès à aucun document. Rien n'est implicite : un Member lit un projet grâce à une autorisation d'équipe ou directe, et quelqu'un sans équipe ni autorisation ne lit rien. L'accès est résolu côté serveur à chaque appel, en une seule requête, et un projet auquel vous avez perdu l'accès répond exactement comme un projet qui n'a jamais existé.
Des rôles qui ne veulent dire qu'une chose chacun
Owner, Admin, Member et Guest dans l'organisation ; Admin, Member et Viewer sur un projet. Un Guest ne voit que ce qui lui a été accordé — l'organisation est pour lui un décor invisible.
Équipes
Accordez un projet à une équipe plutôt qu'à sept personnes, et retirez quelqu'un une seule fois.
Invitations
Une invitation porte une intention — un rôle, des accès à des projets, des équipes — et n'accorde rien tant qu'elle n'est pas acceptée. Le lien fonctionne une fois, expire et peut être révoqué.
Un identifiant, réservé une fois
Réservé une fois, jamais modifié, car quatre tables le dénormalisent à côté d'un nom et un renommage n'a pas de réponse honnête.
Partir sans risque
Vous pouvez partir, sauf si votre départ laisse quelqu'un en plan. Le dernier Owner d'une organisation où se trouvent d'autres personnes doit d'abord la transmettre.
Sécurité
Le Markdown est nettoyé côté serveur, sur une liste blanche
Markdown autorise le HTML brut, donc une balise script dans le README de quelqu'un s'exécuterait sinon dans notre origine avec votre session. C'est le risque le plus grave pour un produit comme celui-ci, et il est fermé avant tout stockage, pas au moment du rendu.
Journal d'audit
Chaque changement de sécurité et de produit, avec qui et quand, écrit dans la même transaction que le changement — si le changement est annulé, l'enregistrement part avec lui.
Sessions et appareils
Une vraie liste des endroits où vous êtes connecté, et une notification quand un nouvel appareil apparaît. Une étiquette de plateforme approximative et une adresse tronquée — pas de ville, pas de pays, aucune supposition sur le caractère inhabituel.
Liste d'adresses autorisées
Refusez toute requête venant d'une adresse que vous n'avez pas nommée, pour les clés d'API comme pour les navigateurs.
Des clés qui survivent aux personnes
Une clé d'API appartient à l'organisation et désigne un seul projet, donc une tâche de CI ne casse pas le jour où la personne qui l'a configurée change d'équipe. Seule son empreinte est stockée, et la révocation prend effet dès la requête suivante.
Deux façons d'entrer, aucune supprimable seule
GitHub, un mot de passe, ou les deux. En retirer un est refusé quand l'autre est absent, si bien qu'un compte ne peut jamais rester sans moyen d'accès.
Santé de la documentation
Trois signaux, aucun n'étant une opinion
Un lien relatif qui ne mène à aucun document. Un document dont le contenu n'a pas changé depuis plus longtemps que votre seuil. Un document qui cite un fichier source modifié après lui — le seul signal du produit qui relie le code à la documentation. Rien ici n'appelle de modèle, donc rien ne coûte quoi que ce soit.
Les constats sont dérivés, pas archivés
Un constat qui a cessé d'être vrai disparaît au lieu d'être résolu. Ce qui survit à la reconstruction, c'est la décision d'une personne qu'un constat était faux.
Le silence sur ce qu'il ne peut pas savoir
Un repository tout juste connecté ne signale aucune obsolescence, quel que soit le seuil, et l'écran le dit au lieu de laisser croire que tout est à jour.
Notifications
Une boîte de réception, pas une seconde copie du journal d'audit
Le journal d'audit dit ce qui s'est passé dans cette organisation ; la boîte de réception dit ce qu'il vous reste à voir. Ce sont deux questions différentes et aucune table ne peut répondre à celle de l'autre — une synchronisation réussie, une réponse à une note, une allocation épuisée et chaque événement de facturation n'écrivent aucune ligne d'audit.
Vous n'êtes jamais notifié à propos de vous-même
L'auteur de l'action n'est jamais destinataire, un doublon encore non lu est supprimé, et quiconque ne peut pas lire le sujet est écarté — un titre est un contenu.
Prévenu une fois, à votre façon
Par catégorie : en temps réel, dans un récapitulatif à votre rythme, ou pas du tout par e-mail. Désactivé veut dire « ne me le dites pas deux fois », donc un récapitulatif ne vous le dira pas ensuite.
La sécurité vous atteint toujours
Aucun interrupteur ne supprime « votre mot de passe a été modifié ». Un réglage qui le permettrait n'aiderait jamais que la personne qui l'a modifié.
Ce que nous refusons délibérément de construire
Ni une feuille de route, ni des choses pour lesquelles le temps a manqué. Chacune a été envisagée puis refusée, et la raison est ce qui empêche le produit de devenir ce qu’il a été conçu pour remplacer.
- Un éditeur pour votre repository
- Les documents du repository sont en lecture seule ici : vous les modifiez dans votre IDE et faites un commit. Les brouillons et les pages du manuel ont un éditeur ; les fichiers de votre repository jamais.
- Un tableau public de commentaires
- Le site public sert à lire. Les retours restent dans Docs Flowy sous forme de notes, où les agents répondent et les personnes les ferment.
- Un wiki avec son propre stockage
- Git est la source de vérité de chaque document du repository. Docs Flowy ne stocke que ce qui se trouve à côté : brouillons, artifacts des agents et pages du manuel.
- Composants MDX personnalisés
- Du CommonMark et du GFM standard. La portabilité est la promesse : votre documentation reste lisible sans nous.
- Notre propre moteur de rendu markdown
- Un problème résolu. Nous en utilisons un bon plutôt que d'en maintenir un moins bon.
- Un fichier de configuration obligatoire
- Une surcharge existe. Elle n'est jamais requise, et en avoir besoin serait un bug de notre part.
Si l'un de ces points est ce qu'il vous faut, nous indiquons quel outil utiliser à la place.