Öffne jetzt Confluence und suche ein Dokument, das du lesen musst. Was siehst du?
Eine Symbolleiste. Schaltflächen zum Bearbeiten. Kommentarfelder. Links zum Seitenverlauf. Eine Seitenleiste voller Navigation, die du nicht brauchst. Brotkrümel. Metadatenfelder. Genehmigungsanzeigen. Eine komplette Autorenoberfläche, die sich um den Text dreht, den du lesen willst.
Überlege dir jetzt, was du eigentlich wolltest: die Antwort auf eine Frage, die nächsten drei Schritte in einem Prozess oder eine Richtlinie, die du vor einem Meeting in zehn Minuten nachschlagen musst.
Du bist gekommen, um zu konsumieren. Die Benutzeroberfläche geht davon aus, dass du gekommen bist, um zu erstellen.
Das ist der Standard bei fast allen Dokumentationsplattformen. Confluence, Notion, SharePoint, GitBook, Nuclino, Slite. Sie alle bieten Lesern und Schreibern die gleiche Umgebung. Die Seite ist die Seite. Jeder erhält die gleiche Ansicht, abgesehen von ein paar Schaltflächen mit Berechtigungen.
Es fühlt sich normal an, weil wir noch nie etwas anderes hatten. Aber es ist eine Designentscheidung, kein Naturgesetz. Und es ist die falsche Entscheidung.
Die gleiche Schnittstelle für Lesen und Schreiben schafft kognitiven Overhead](/de/blog/img/readers-writers-ui.svg)
Lesen und Schreiben sind nicht dieselbe kognitive Aufgabe
Das ist keine Vorliebe für die Benutzeroberfläche. Es ist ein grundlegender Unterschied in der Arbeitsweise des Gehirns.
Wenn du schreibst, befindest du dich im generativen Modus. Du konstruierst, organisierst, entscheidest, was du einfügst und was du weglässt. Du brauchst Werkzeuge: Formatierungsoptionen, Strukturkontrollen, Medieneinbettung, Metadatenfelder, Versionsgeschichte, Funktionen zur Zusammenarbeit. Die Schnittstelle sollte dir Macht und Flexibilität geben.
Wenn du liest, bist du im rezeptiven Modus. Du scannst, filterst, nimmst das Relevante heraus und versuchst, weiterzulesen. Du brauchst Klarheit: saubere Typografie, konzentriertes Layout, minimale Ablenkung. Die Benutzeroberfläche sollte dir nicht im Weg sein.
Die Kognitionspsychologie hat dafür einen klaren Rahmen. Die [Cognitive Load Theory] (https://www.instructionaldesign.org/theories/cognitive-load/), die von John Sweller in den späten 1980er Jahren entwickelt wurde, unterscheidet zwischen intrinsischer Belastung (die Schwierigkeit des Stoffes selbst), germane Belastung (die Anstrengung des Lernens und der Integration) und extraneaner Belastung (alles, was die Umgebung hinzufügt und nicht hilfreich ist). Jede Symbolleiste, jede Seitenleiste und jede Bearbeitungsschaltfläche, die ein Leser sieht, ist überflüssig. Sie helfen dem Leser nicht, den Inhalt zu verstehen. Sie konkurrieren aktiv um die Aufmerksamkeit.
Eine Studie von Mayer und Moreno (2003) über multimediales Lernen hat gezeigt, dass die Reduzierung überflüssiger Elemente sowohl das Verständnis als auch das Behalten verbessert. Ihr Kohärenzprinzip ist direkt: Menschen lernen besser, wenn überflüssiges Material ausgeschlossen und nicht hinzugefügt wird. Eine Dokumentationsoberfläche, die dem Leser bei jedem Seitenaufruf die Steuerelemente des Autors zeigt, verstößt gegen dieses Prinzip.
Der Leser muss die Werkzeuge des Autors nicht sehen. Sie trotzdem zu zeigen, ist nicht neutral. Es ist aktiv schädlich für das Verstehen.
Wie aktuelle Plattformen dies handhaben (meistens nicht)
Schauen wir uns an, was es gibt.
Confluence hat einen Lesemodus und einen Bearbeitungsmodus, aber der Lesemodus ist immer noch von der Navigation, den Metadaten und dem Seitenbaum der Plattform umgeben. Die Bearbeitungssymbolleiste verschwindet, wenn du nicht bearbeitest, aber der mentale Rahmen "dies ist eine bearbeitbare Wikiseite" verschwindet nie ganz. Jeder Leser sieht die Schaltfläche "Bearbeiten". Die Seite flüstert: Du könntest das ändern.
Notion ist in dieser Hinsicht noch schlimmer. Der Kern der Designphilosophie ist, dass alles immer bearbeitbar ist. Klicke irgendwo und du tippst. Das ist genial für Autoren. Für Leserinnen und Leser, die den Inhalt einfach nur aufnehmen wollen, ohne Angst haben zu müssen, dass sie aus Versehen etwas ändern, ist es schrecklich. Die [Vorlagengalerie] (https://www.notion.com/templates) von Notion zeigt das: Jede Vorlage ist ein Arbeitsbereich, keine Veröffentlichung.
SharePoint unterstützt technisch gesehen verschiedene Seitenlayouts für die Anzeige und Bearbeitung, aber das Gesamterlebnis ist immer noch ein Unternehmensintranet. Die Leserinnen und Leser haben das Gefühl, dass sie sich in einem Unternehmenstool befinden und nicht in einem für das Verständnis optimierten Dokument.
GitBook kommt mit seiner sauberen, dokumentationsähnlichen Ausgabe einem Leseerlebnis am nächsten. Aber auch hier wird davon ausgegangen, dass der Leser ein Entwickler ist, der sich technische Dokumente ansieht. Es ist nicht für den allgemeinen Wissenskonsumenten gedacht.
Keine dieser Plattformen behandelt das Lesen als eine grundlegend andere Aktivität als das Schreiben. Sie behandeln es als Schreiben mit ausgeblendeter Symbolleiste.
Die Kosten einer einzigen Schnittstelle
Das ist nicht nur ein Problem der Ästhetik. Es hat messbare Konsequenzen.
Die Informationsflut verringert das Verstehen
Eine im Journal of Consumer Research veröffentlichte Studie fand heraus, dass Informationsüberlastung zu einer schlechteren Entscheidungsqualität führt, wobei der Effekt mit dem Verhältnis von irrelevanten zu relevanten Informationen zunimmt. Eine Dokumentationsseite mit sichtbaren Steuerelementen, Navigationsbäumen und Metadatenfeldern erhöht dieses Verhältnis für jeden Leser, der nicht zum Schreiben da ist.
Context Switching hat einen echten Preis
Wenn ein Interface signalisiert: "Du kannst das bearbeiten", aktiviert es einen anderen kognitiven Rahmen als "Lies das." [Gloria Marks Forschung an der UC Irvine (https://www.ics.uci.edu/~gmark/) über Aufmerksamkeit und Multitasking hat ergeben, dass es durchschnittlich 23 Minuten und 15 Sekunden dauert, bis man sich nach einem Kontextwechsel wieder voll konzentriert. Ein Leser, der kurz darüber nachdenkt, etwas zu bearbeiten (selbst um einen Tippfehler zu korrigieren), wurde aus dem Lesemodus gerissen. Das ist keine hypothetische Annahme. Jeder, der Notion benutzt hat, kennt die Erfahrung, wenn man auf einen Text klickt, um ihn auszuwählen, und dann versehentlich anfängt zu tippen.
Leser und Schreiber haben unterschiedliche Bedürfnisse an denselben Inhalt
Ein Autor muss die Struktur, Formatierungsmarkierungen, Blocktypen, Metadaten und Signale für die Zusammenarbeit sehen. Sie brauchen die ganze Maschinerie.
Ein Leser braucht sauberen Text, eine klare Hierarchie und den schnellsten Weg zu den gesuchten Informationen. Sie brauchen den Inhalt, nicht die Maschinerie.
Werden beide über dieselbe Schnittstelle bedient, bedeutet das, dass keiner von ihnen ein für seine eigentliche Tätigkeit optimiertes Erlebnis hat.
Und dann ist da noch die dritte Zielgruppe: KI
Hier wird es kompliziert, und die bestehenden Plattformen sind völlig unvorbereitet.
Die Dokumentation im Jahr 2026 hat drei verschiedene Verbraucher, nicht zwei:
- Autoren, die Inhalte erstellen und pflegen
- Leser, die Inhalte visuell konsumieren
- KI-Systeme, die Inhalte programmgesteuert abrufen, analysieren und zusammenstellen
Jedes dieser Zielgruppen braucht eine grundsätzlich andere Schnittstelle zu denselben zugrunde liegenden Inhalten.
Autoren brauchen umfangreiche Bearbeitungswerkzeuge, Funktionen zur Zusammenarbeit und strukturelle Kontrollen. Leser brauchen eine übersichtliche, konzentrierte Darstellung mit minimaler Ablenkung. KI braucht eine strukturierte, maschinenlesbare Ausgabe mit expliziten Metadaten: Aktualitätssignale, Klassifizierungskennzeichen, Adressierung auf Blockebene und saubere semantische Markups.
Wie wir in Builders, Not Developers erörtert haben, sind KI-Vermittler bereits der dominierende Konsument von Dokumentation für einen wachsenden Teil der Wissensarbeiter. Die [GitHub-Entwicklerumfrage 2024] (https://github.blog/news-insights/research/survey-ai-wave-grows/) ergab, dass 97 % der Entwickler in Unternehmen KI-Codierwerkzeuge verwenden. Bis 2026 werden 84% der Entwickler regelmäßig KI-Tools nutzen, wobei 41% des gesamten Codes durch KI generiert werden.
Diese KI-Systeme interessieren sich nicht für deine Seitenleiste oder deine Symbolleiste. Sie brauchen saubere Daten. Und eine Plattform, die die Lesersicht mit der Autorensicht verwechselt, verwechselt auch die von der KI konsumierbare Oberfläche mit der Oberfläche des menschlichen Verfassers. Das sind drei Unstimmigkeiten in einer Schnittstelle.
Drei Zielgruppen, drei unterschiedliche Bedürfnisse](/de/blog/img/readers-writers-three-audiences.svg)
Wie Rasepi die Erfahrungen trennt
Rasepi basiert auf dem Prinzip, dass das Erstellen von Inhalten und das Konsumieren von Inhalten unterschiedliche Aktivitäten sind, die unterschiedliche Schnittstellen verdienen.
Die Umgebung des Autors
Wenn du in Rasepi schreibst, bekommst du eine vollständige Autorenumgebung. Rich-Text-Editing mit TipTap, Steuerelemente auf Blockebene, Übersetzungsstatusanzeigen, Ablaufmanagement, Tools für die Zusammenarbeit, Ansichten für die Inhaltsstruktur und alles andere, was ein Autor braucht, um qualitativ hochwertige Dokumentation zu erstellen und zu pflegen.
Der Autor sieht die Maschinerie, weil er die Maschinerie braucht.
Die Umgebung des Lesers
Wenn jemand ein Rasepi-Dokument konsumiert, sieht er ein sauberes, konzentriertes Leseerlebnis. Kein Bearbeitungs-Chrome. Keine Symbolleisten. Keine "Du kannst das ändern"-Signale. Nur der Inhalt, der in einem Layout präsentiert wird, das für das Verstehen und Überfliegen optimiert ist.
Der Leser sieht die Schaltfläche "Bearbeiten" nicht, denn er ist nicht hier, um zu bearbeiten. Er ist hier, um etwas zu lernen, einen Prozess zu verfolgen oder eine Antwort zu finden. Die Benutzeroberfläche respektiert diese Absicht.
Die KI-Oberfläche
Für KI-Konsumenten stellt Rasepi Inhalte über strukturierte APIs mit vollständigen Metadaten zur Verfügung. Jeder Block enthält einen Freshness Score, einen Übersetzungsstatus, einen Content Hash und Klassifizierungskennzeichen. KI-Systeme können Inhalte auf Blockebene abfragen, nach Aktualität filtern, veraltetes Material oder Entwürfe ausschließen und genau die strukturierten Daten abrufen, die sie benötigen.
Kein Scraping einer Wikiseite und Hoffen auf das Beste. Die KI erhält eine speziell entwickelte Schnittstelle, genau wie der Leser und der Autor.
Eine Inhaltsebene, drei Schnittstellen
Das Wichtigste ist, dass wir nicht drei Kopien des Inhalts verwalten. Das ist nicht das Problem der fünf Kopien des Onboardings, das wir in Stop Maintaining Five Copies of the Same Document besprochen haben.
Es handelt sich um eine Inhaltsebene, die in strukturierten Blöcken gespeichert ist und über drei verschiedene Ansichten für drei verschiedene Zielgruppen optimiert wird.
Der Autor bearbeitet die Blöcke. Der Leser sieht zusammengestellte, gestylte Inhalte. Die KI fragt strukturierte Daten mit Metadaten ab. Dieselben Blöcke. Dieselbe Quelle der Wahrheit. Unterschiedliche Präsentationsschicht für jeden Verbraucher.
Dies ist nur aufgrund der Architektur auf Blockebene möglich. Jeder Inhalt ist eine individuell adressierbare Einheit mit eigenen Metadaten. Du kannst diese Blöcke unterschiedlich präsentieren, je nachdem, wer nach ihnen fragt:
| Zielgruppe | Bedürfnisse | Gets |
|---|---|---|
| Writer | Formatierung, Struktur, Zusammenarbeit, Metadaten | Vollständige Authoring-Umgebung mit Kontrollen auf Blockebene |
| Leser | Sauberer Text, klare Hierarchie, schnelles Scannen | Fokussierte Leseansicht, kein Bearbeitungs-Chrome |
| AI | Strukturierte Daten, Freshness Scores, Klassifizierung | Block-Level-API mit vollständigen Metadaten |
Warum das wichtiger ist, als es aussieht
Du liest das vielleicht und denkst: "Das ist nur UI. Verschiedene Ansichten der gleichen Sache. Wie wichtig kann das schon sein?"
Sehr wichtig, wie sich herausstellt.
Leservertrauen
Menschen vertrauen Inhalten, die veröffentlicht aussehen. Wenn eine Seite wie ein Wiki aussieht, das jeder bearbeiten kann, wird sie von den Lesern unbewusst abgelehnt. Wenn derselbe Inhalt in einer sauberen, veröffentlichungsreifen Ansicht präsentiert wird, hat er mehr Autorität. Das ist nicht irrational. Es ist ein Zeichen dafür, dass jemand die Präsentation ernst genommen hat, was bedeutet, dass er auch den Inhalt ernst genommen hat.
Die Nielsen Norman Group hat dies eingehend untersucht. Ihre [Studie zur Glaubwürdigkeit von Inhalten] (https://www.nngroup.com/articles/trust-signals-content/) zeigt, dass die Qualität des Designs und der Präsentation zu den stärksten Signalen gehören, anhand derer die Nutzer die Vertrauenswürdigkeit von Inhalten beurteilen. Eine unübersichtliche Editoransicht untergräbt aktiv die Glaubwürdigkeit der angezeigten Inhalte.
Produktivität des Autors
Autoren, die in einer speziellen Autorenumgebung arbeiten, müssen nicht zwischen den Kontexten "lese ich oder schreibe ich?" hin und her wechseln. Die Werkzeuge sind da, weil sie da sein sollen, und nicht, weil die Benutzeroberfläche nicht entscheiden konnte, wer auf sie schaut.
KI-Zuverlässigkeit
Wenn KI-Systeme über eine speziell entwickelte Oberfläche mit strukturierten Metadaten verfügen, können sie besser entscheiden, was sie abrufen und was sie ausschließen. Sie können Freshness-Scores überprüfen, bevor sie einen Block in eine Antwort aufnehmen. Sie können Klassifizierungskennzeichen beachten. Sie können nach Sprache, Status oder Zielgruppe filtern. All das ist nicht möglich, wenn die KI dieselbe HTML-Seite ausliest, die für menschliche Leser konzipiert wurde.
Der Wechsel des mentalen Modells
Die Grundannahme der meisten Dokumentationsplattformen ist: die Seite ist die Einheit, und jeder interagiert mit der Seite.
Rasepi geht von einer anderen Annahme aus: Der Block ist die Einheit, und verschiedene Zielgruppen interagieren mit den Blöcken durch speziell entwickelte Oberflächen.
Das klingt wie ein kleiner architektonischer Unterschied. Ist es aber nicht. Es ist der Unterschied zwischen einem Werkzeug, das KI-Systemen zufällig Inhalte zeigt, und einem, das sie absichtlich bedient. Zwischen einer Schreibumgebung, die zufällig lesbar ist, und einem Leseerlebnis, das von Grund auf neu entwickelt wurde. Zwischen einer guten Schnittstelle und drei großartigen.
Dokumentation wird nicht mehr nur geschrieben und gelesen. Sie wird geschrieben, gelesen, abgefragt, übersetzt, bewertet, klassifiziert und in großem Umfang an KI-Systeme weitergegeben. Wenn wir so tun, als ob wir das könnten, haben wir Wikis, die niemand lesen will, und KI-Assistenten, die Antworten von Seiten abrufen, die nie dafür gedacht waren, maschinell verarbeitet zu werden.
Leser und Schreiber befinden sich in unterschiedlichen Denkmodi. Die KI ist in einem ganz anderen Modus. Die Benutzeroberfläche sollte das widerspiegeln.