Nous avons sorti la documentation de la modale

Vous écrivez la page d'onboarding d'un service de paiement. Six titres, deux blocs de code, un tableau des queues qu'il consomme, et un paragraphe que vous n'arrêtez pas de réécrire parce que c'est le paragraphe que le prochain ingénieur lira vraiment.

Dans Archyl, jusqu'à cette semaine, vous écriviez tout ça dans une boîte de dialogue. La page derrière s'assombrissait. L'arborescence des documents, là où vivent les pages voisines et où vous seriez allé vérifier comment vous aviez nommé la précédente, s'assombrissait avec elle. L'éditeur remplissait la boîte de dialogue, la boîte de dialogue n'était pas l'écran, et lire une page et écrire une page se passaient à deux endroits différents.

Ça marchait. Ça ne faisait pas non plus vraiment professionnel, et c'est la phrase à laquelle je revenais sans arrêt jusqu'à ce que je m'y mette et que je le reconstruise.

L'espace de travail de documentation n'a plus de modale. Voici ce qui l'a remplacée.

L'éditeur s'ouvre là où est le document

Cliquez sur Éditer sur une page, ou appuyez sur E pendant que vous la lisez, et l'éditeur prend la colonne de contenu sur place. L'arborescence reste où elle était, en pleine lumière, toujours cliquable. Rien ne se superpose à rien.

Le document ressemble à un document pendant que vous l'écrivez. Le titre est un simple champ à la taille d'un titre, sans libellé et sans encadré autour. Les tags sont juste en dessous : tapez et appuyez sur Enter ou sur la virgule pour en ajouter un, backspace dans un champ vide pour reprendre le dernier. Le chemin du dossier court en haut de la barre d'actions, pour que vous sachiez toujours où atterrira la page que vous êtes en train d'écrire.

La barre porte aussi l'état. Un point ambre et Modifications non enregistrées tant que le brouillon diffère de ce qui est stocké, puis Enregistrer avec son indication ⌘↵. Ce raccourci fonctionne depuis n'importe où dans l'éditeur, y compris depuis le corps Markdown, vous n'avez donc jamais à refaire le chemin jusqu'au bouton. Il y a une bascule plein écran à côté du sélecteur de mode quand vous voulez le paragraphe et rien d'autre, et Escape vous ramène. Le long du bord inférieur, un nombre de mots et un temps de lecture.

Écrire, Côte à côte, Aperçu

L'éditeur a trois modes, et c'est la seule décision de barre d'outils que vous avez à prendre :

• Écrire, c'est du Markdown seul, sur toute la largeur de la colonne.
• Côte à côte place la source et la page rendue l'une à côté de l'autre.
• Aperçu, c'est la page rendue toute seule.

Côte à côte est le mode par défaut. Quel que soit celui que vous choisissez, Archyl le garde dans votre navigateur et rouvre chaque document ainsi : la personne qui écrit en Markdown brut et celle qui veut voir les titres rendus n'ont donc jamais à en débattre ni à le réinitialiser sur chaque page.

Les dossiers sont une ligne dans l'arborescence

Créer un dossier, c'était avant sa propre boîte de dialogue : un encadré, un champ texte, un bouton Créer, et aucune idée de l'endroit où le dossier allait apparaître.

Maintenant, cliquer sur l'icône de dossier dans l'en-tête de l'arborescence ouvre une ligne éditable exactement là où le dossier vivra, à la bonne indentation, avec l'icône de dossier déjà dessinée. Tapez le nom, appuyez sur Enter, et il existe. Escape annule. Demandez un sous-dossier depuis le menu d'un dossier et le parent se déplie, la ligne apparaît à l'intérieur.

Renommer fonctionne pareil, dans la ligne. Déplacer pages et dossiers reste du glisser-déposer.

On ne peut pas cliquer ailleurs en laissant du travail non enregistré

Chaque mouvement dans l'espace de travail de documentation passe par un seul garde-fou : sélectionner une autre page dans l'arborescence, commencer une nouvelle page, en ouvrir une autre en édition, annuler et sortir de l'éditeur. Si le brouillon a des modifications non enregistrées, l'action est retenue et vous recevez d'abord une confirmation, avec Continuer l'édition comme sortie et Abandonner comme choix délibéré. Une fois que vous confirmez, l'action que vous aviez demandée s'exécute.

Le navigateur est couvert lui aussi. Fermer l'onglet avec un brouillon non enregistré déclenche l'avertissement propre au navigateur.

C'est le changement le moins visible de cette release et celui que je défendrais le plus fort. Une arborescence de pages cliquables à côté d'un éditeur n'est une bonne mise en page que si cliquer ne peut pas vous coûter un paragraphe.

Le sommaire suit le panneau, pas la fenêtre

Quand la colonne est assez large, les titres de la page se placent dans un rail collant à droite du texte, la section courante étant marquée au fil du défilement. Quand elle est trop étroite pour un rail, ils se replient dans un popover Sommaire de la barre d'outils.

La bascule entre les deux est pilotée par la largeur du panneau, pas par celle de la fenêtre du navigateur. Toute la question est là : la colonne des docs partage sa place avec l'arborescence, un écran 27 pouces avec l'arborescence ouverte est donc une fenêtre large autour d'une colonne de lecture étroite. Un breakpoint basé sur la fenêtre y mettrait un rail et écraserait le texte. Les container queries de Tailwind 4 font que le panneau se mesure lui-même.

Cliquer sur un titre fait défiler l'article, et seulement l'article. Le rail fait défiler sa propre liste pour garder l'entrée active en vue sans déplacer le document sous vos yeux.

Ce qui a quitté la pile

Quatre composants ont été purement et simplement supprimés dans cette release : la modale de document, la modale de création de dossier, l'ancienne sidebar de sommaire, et une page de documentation en liste de cartes que plus rien n'affichait.

L'éditeur Markdown reste @uiw/react-md-editor, mais son style vient désormais des mêmes design tokens que le reste d'Archyl. Clair et sombre forment un seul jeu de règles au lieu d'un bloc d'overrides par thème posé par-dessus celui de la librairie.

Les pièces jointes ne changent pas et fonctionnent exactement comme avant : déposez un fichier sur l'éditeur, collez une capture d'écran, ou utilisez Joindre. Les images s'intègrent dans le texte, tout le reste atterrit dans le panneau des pièces jointes, et le compteur de trombone dans l'en-tête de la page vous y emmène d'un bond. L'histoire complète est dans Glissez, déposez, c'est fait : les fichiers arrivent dans les docs Archyl.

Pourquoi s'embêter à redessiner une zone de texte

Le travail d'Archyl, c'est de garder le modèle d'architecture fidèle au code, et la discovery fait cette partie toute seule. La prose autour du modèle n'a droit à aucune aide de ce genre. L'ADR qui explique pourquoi la queue est là, la page d'onboarding, le runbook : ceux-là ne restent vrais que parce que quelqu'un continue de les écrire, et les gens écrivent moins quand la surface d'écriture leur résiste.

Une modale était un petit impôt prélevé absolument à chaque fois. Il a disparu.

Connectez-vous, ouvrez Docs sur n'importe quel projet, et appuyez sur E sur une page. Il n'y a rien à activer et aucune étape de migration : vos pages, dossiers et pièces jointes sont là où vous les avez laissés. Le guide de la fonctionnalité est sur Documentation & ADRs.