Wir haben die Dokumentation aus dem Modal geholt

Du schreibst die Onboarding-Seite für einen Payment-Service. Sechs Überschriften, zwei Code-Blöcke, eine Tabelle der Queues, die er konsumiert, und ein Absatz, den du immer wieder umschreibst, weil es der Absatz ist, den der nächste Engineer tatsächlich lesen wird.

In Archyl hast du all das bis diese Woche in einem Dialog geschrieben. Die Seite dahinter wurde dunkel. Der Dokumentenbaum, in dem die Nachbarseiten liegen und in dem du nachgeschaut hättest, wie du die letzte genannt hast, wurde mit ihr dunkel. Der Editor füllte den Dialog, der Dialog war nicht der Bildschirm, und eine Seite zu lesen und eine Seite zu schreiben passierte an zwei verschiedenen Orten.

Es funktionierte. Es fühlte sich auch nicht wirklich professionell an — das ist der Satz, zu dem ich immer wieder zurückkam, bis ich mich hingesetzt und es neu gebaut habe.

Im Dokumentations-Workspace gibt es kein Modal mehr. Das hier ist an seine Stelle getreten.

Der Editor öffnet dort, wo das Dokument ist

Klick auf einer Seite auf Bearbeiten oder drück beim Lesen E, und der Editor übernimmt die Inhaltsspalte an Ort und Stelle. Der Baum bleibt, wo er war, in voller Helligkeit, weiterhin klickbar. Nichts legt sich über irgendetwas.

Das Dokument sieht beim Schreiben aus wie ein Dokument. Der Titel ist ein schlichtes Feld in Überschriftengröße, ohne Label und ohne Kasten darum. Die Tags sitzen darunter: tippen und Enter oder Komma drücken, um eines hinzuzufügen, Backspace in einem leeren Feld, um das letzte zurückzunehmen. Der Ordnerpfad läuft oben an der Aktionsleiste entlang, damit du immer weißt, wo die Seite landen wird, die du gerade schreibst.

Die Leiste trägt auch den Zustand. Ein bernsteinfarbener Punkt und Ungespeicherte Änderungen, solange sich der Entwurf von dem unterscheidet, was gespeichert ist, dann Speichern mit seinem ⌘↵-Hinweis. Dieses Kürzel funktioniert von überall im Editor, auch aus dem Markdown-Text heraus, du musst also nie zum Button zurückreisen. Neben dem Moduswechsel gibt es einen Vollbild-Schalter, wenn du den Absatz und sonst nichts willst, und Escape bringt dich zurück. Am unteren Rand eine Wortzahl und eine Lesezeit.

Schreiben, Geteilt, Vorschau

Der Editor hat drei Modi, und sie sind die einzige Toolbar-Entscheidung, die du treffen musst:

• Schreiben ist nur Markdown, über die volle Breite der Spalte.
• Geteilt stellt Quelltext und gerenderte Seite nebeneinander.
• Vorschau ist allein die gerenderte Seite.

Geteilt ist der Standard. Egal, welchen du wählst, Archyl merkt ihn sich in deinem Browser und öffnet jedes Dokument wieder so — die Person, die rohes Markdown schreibt, und die Person, die die Überschriften gerendert sehen will, müssen sich also nie darüber streiten oder es auf jeder Seite neu einstellen.

Ordner sind eine Zeile im Baum

Einen Ordner anzulegen war früher ein eigener Dialog: ein Kasten, ein Textfeld, ein Erstellen-Button und keine Ahnung, wo der Ordner gleich auftauchen würde.

Jetzt öffnet ein Klick auf das Ordnersymbol in der Kopfzeile des Baums eine editierbare Zeile genau dort, wo der Ordner leben wird, mit der richtigen Einrückung und bereits gezeichnetem Ordnersymbol. Namen tippen, Enter drücken, und er existiert. Escape bricht ab. Verlangst du aus dem eigenen Menü eines Ordners einen Unterordner, klappt der übergeordnete auf und die Zeile erscheint darin.

Umbenennen funktioniert genauso, in der Zeile. Seiten und Ordner verschiebst du weiterhin per Drag and Drop.

Du kannst dich nicht von ungespeicherter Arbeit wegklicken

Jede Bewegung im Dokumentations-Workspace läuft durch einen einzigen Wächter: eine andere Seite im Baum auswählen, eine neue Seite anfangen, eine weitere zum Bearbeiten öffnen, den Editor abbrechen. Hat der Entwurf ungespeicherte Änderungen, wird die Aktion angehalten und du bekommst zuerst eine Bestätigung, mit Weiter bearbeiten als Ausweg und Änderungen verwerfen als der bewussten Variante. Sobald du bestätigst, läuft die Aktion, um die du ursprünglich gebeten hast.

Der Browser ist ebenfalls abgedeckt. Wer den Tab mit einem ungespeicherten Entwurf schließt, bekommt die eigene Warnung des Browsers.

Das ist die unsichtbarste Änderung dieses Releases und die, die ich am härtesten verteidigen würde. Ein Baum aus klickbaren Seiten neben einem Editor ist nur dann ein gutes Layout, wenn ein Klick dich keinen Absatz kosten kann.

Das Inhaltsverzeichnis folgt dem Panel, nicht dem Fenster

Ist die Spalte breit genug, sitzen die Überschriften der Seite in einer klebenden Leiste rechts vom Text, und der aktuelle Abschnitt wird beim Scrollen markiert. Ist sie zu schmal für eine Leiste, klappen sie stattdessen in ein Inhalt-Popover in der Toolbar.

Der Wechsel zwischen beiden wird von der Breite des Panels gesteuert, nicht von der Breite des Browserfensters. Genau darum geht es: Die Docs-Spalte teilt sich ihren Platz mit dem Baum, ein 27-Zoll-Monitor mit offenem Baum ist also ein breites Fenster um eine schmale Lesespalte. Ein fensterbasierter Breakpoint würde dort eine Leiste hinstellen und die Prosa quetschen. Container Queries von Tailwind 4 lassen das Panel sich selbst vermessen.

Ein Klick auf eine Überschrift scrollt den Artikel, und nur den Artikel. Die Leiste scrollt ihre eigene Liste, um den aktiven Eintrag im Blick zu behalten, ohne dir das Dokument unter den Füßen wegzuziehen.

Was vom Stapel geflogen ist

Vier Komponenten wurden in diesem Release ersatzlos gelöscht: das Dokument-Modal, das Ordner-anlegen-Modal, die alte Inhaltsverzeichnis-Sidebar und eine Dokumentationsseite mit Kartenliste, die nichts mehr gerendert hat.

Der Markdown-Editor ist weiterhin @uiw/react-md-editor, aber sein Styling kommt jetzt aus denselben Design-Tokens wie der Rest von Archyl. Hell und Dunkel sind ein einziges Regelwerk statt eines Override-Blocks pro Theme, der auf dem der Bibliothek sitzt.

Anhänge sind unverändert und funktionieren genau wie vorher: eine Datei auf den Editor ziehen, einen Screenshot einfügen oder Anhängen benutzen. Bilder werden inline eingebettet, alles andere landet im Anhänge-Panel, und die Büroklammer-Zahl in der Kopfzeile der Seite springt dorthin. Die ganze Geschichte steht in Ziehen, ablegen, fertig: Dateien kommen in die Archyl-Docs.

Warum man ein Textfeld überhaupt neu gestaltet

Archyls Aufgabe ist es, das Architekturmodell mit dem Code in Übereinstimmung zu halten, und die Discovery erledigt diesen Teil von allein. Die Prosa rund um das Modell bekommt keine solche Hilfe. Das ADR, das erklärt, warum die Queue da ist, die Onboarding-Seite, das Runbook: Die bleiben nur wahr, weil jemand sie immer weiter schreibt — und Menschen schreiben weniger, wenn die Schreibfläche sich gegen sie wehrt.

Ein Modal war eine kleine Steuer, die jedes einzelne Mal fällig wurde. Sie ist weg.

Melde dich an, öffne Docs in einem beliebigen Projekt und drück auf einer Seite E. Es gibt nichts einzuschalten und keinen Migrationsschritt: deine Seiten, Ordner und Anhänge liegen da, wo du sie gelassen hast. Der Feature-Guide steht unter Dokumentation & ADRs.