Seiten und Knoten

Die Form folgt dem Gewicht, und das Gewicht ändert sich

Ein Knoten ist für eine Aussage samt ihrer Begründung gedacht, ein Listenpunkt für eine Zeile, eine Tabellenzelle für ein Wort. Eine Tabelle dient dazu, Werte entlang ihrer Zeilen zu vergleichen; eine Menge von Entitäten gehört deshalb in Knoten statt in Tabellenzeilen. Das Gewicht ändert sich, wenn ein Thema wächst oder schrumpft, und so überschreiten Inhalte diese Grenzen in beide Richtungen: Ein Listenpunkt, der zu Absätzen angeschwollen ist, wird zu einem Knoten, eine Liste, die dem Namen über ihr entwachsen ist, wird zu Abschnitten, und mehrere Knoten mit je einem Satz werden zu einer Liste.

Eine im Text versteckte Aussage hat keine Adresse und erscheint nie in der Gliederung. Sie versteckt sich als fett gesetzter Einstieg, als Listenpunkt, der sich über Absätze zieht, als Zeile in einer Katalogtabelle oder als zweite Aussage im selben Block; eine in einen Text getippte ##-Überschrift ist dasselbe. Sie versteckt sich auch in schlichtem Fließtext, ganz ohne Kennzeichen: Eine Seite aus korrekt benannten Abschnitten, unter denen keine untergeordneten Knoten stehen, enthält jede ihrer Aussagen im Text, und ein Leser, der ihre Gliederung überfliegt, erfährt keine davon. Das Gegenstück ist eine Überschrift über einem einzigen Satz, die eine Gliederungszeile und einen Bildschirm voll Leerraum für etwas verbraucht, das ein Listenpunkt sagte.

Beide Fehler sind von außen zu erkennen. Auf einer gut gegliederten Seite hat jede Aussage eines Textes ihre Zeile in der Gliederung. Und ein Text, der sich bei verdecktem Titel wie eine Fußnote zu seiner eigenen Überschrift liest, ist ein Listenpunkt.

Der Titel trägt genau das, was der Text enthält

Auf h2-Ebene benennt der Titel einen Abschnitt, als Nominalgruppe aus wenigen Wörtern: Die oberste Ebene wird als Inhaltsverzeichnis gelesen, und ein Satz dort konkurriert mit dem Titel der Seite selbst. Tiefer formuliert der Titel die Aussage, und der Text begründet sie; dadurch kann ein Leser die Aussage aus der Gliederung entnehmen und den Text nur für die Begründung öffnen. Ein Knoten, der untergeordnete Knoten gruppiert, benennt auf jeder Ebene einen Abschnitt.

Die Abschnitte geben den Aussagen ihre Form. Ohne sie ist eine Seite eine Reihe von h2-Aussagen, wie sie ein einziger Schreibdurchgang hinterlässt, und muss ganz gelesen werden, bevor sich etwas darin findet.

Was eine eigene Seite rechtfertigt

Ein Thema ist eine Seite, wenn ein Leser direkt dorthin gelangen würde, und ein Block, wenn es losgelöst von seinem übergeordneten Knoten nichts bedeutet. Dieselbe Probe teilt ein gewachsenes Thema: Ab ein paar Dutzend Gliederungszeilen oder einigen Bildschirmseiten Text wird eine Seite durchgescrollt statt gelesen, und ihre Inhaltsleiste ist keine Karte mehr; deshalb ist ein Abschnitt, der sich ohne Vorwissen öffnen lässt, eine eigene Seite, und Abschnitte, die nur in ihrer Abfolge Sinn ergeben, bleiben stattdessen kurz.

Eine Seite als Beispiel

Nur die Titel – so begegnet ein Leser einer Seite:

Visabestimmungen
  Wer ein Visum braucht
    EU-Bürger brauchen keines
    Ein Transitaufenthalt zählt als Einreise
  Beantragung
    Das Formular wird nur online eingereicht
    Die Gebühren werden im Konsulat bezahlt

Die beiden h2-Titel benennen die Abschnitte. Die vier Aussagen darunter sind das, was die Seite enthält; so entnimmt ein Leser eine Aussage der Gliederung und öffnet einen Text nur für die Begründung. Unter dem dritten Titel begründet der Text die Aussage und sagt nichts, was der Titel schon gesagt hat:

Die Grenzbehörde wertet einen Umstieg im Transitbereich als Einreise, daher braucht ein Reisender, der nur das Flugzeug wechselt, dasselbe Visum wie einer, der den Flughafen verlässt. Die Fluggesellschaft setzt das beim Check-in durch, und dort fällt ein fehlendes Visum meist auf.

Eine Seite mit Unterseiten macht auf sie aufmerksam, statt sie aufzuzählen

Die Startseite und jede Seite mit Unterseiten beginnen mit dem, was darunter lesenswert ist, und verlinken einige Seiten, derentwegen Leser kommen, auch tief liegende: ausgewählte Links statt einer Kopie des Baums, den der Leser ohnehin neben dem Text hat. Eine Liste aller Unterseiten gehört nur dorthin, wo der Leser unter allen wählen muss, etwa bei den Installationswegen. Eine solche Seite hat eigene Abschnitte statt nur eines Vorspanns: Ohne sie hat sie keine Inhaltsleiste und wirkt unfertig.

Ein Text, der wiederholt, was das System festhält, veraltet

Jeder Knoten trägt seinen eigenen Versionsverlauf, sein eigenes updated_at, seinen Platz in der Inhaltsleiste und die Liste der Knoten, die auf ihn verlinken. Ein Text, der davon etwas wiederholt, veraltet in dem Moment, in dem jemand die Seite oder ihre Struktur ändert, ohne diesen Satz anzupassen, und gibt dann Falsches wieder.

Ein solider Text enthält daher nichts davon: keinen Block, der sein eigenes Veralten dokumentiert, denn der Versionsverlauf enthält, was er ersetzt hat; keinen Vermerk „im April geprüft“, denn er veraltet von selbst und sagt nichts Verlässliches darüber, ob der Inhalt aktuell ist; keinen Fließtext, der die Abschnitte darunter aufzählt, denn die Leiste zählt sie auf; keine Fußzeile „zurück zu X“, denn die Rückverweise stehen bereits auf der Seite. Entscheidend ist, woher ein Satz seine Wahrheit bezieht. Aus dem Baum dieser Seite – dann fällt er weg, denn der Leser sieht diesen Baum, und der ändert sich, ohne den Satz zu fragen. Aus dem Thema – dann bleibt er, selbst wenn seine Zahl heute zufällig mit dem Baum übereinstimmt: Ein Gründungsjahr ist Inhalt, ein Prüfdatum gehört zu den Metadaten, und drei Robotergesetze bleiben drei, was auch immer dieses Wiki tut.

Wie ein Verweis einen Knoten erreicht

Ein Kurzverweis, page:N oder block:N, zeigt auf den Knoten, nicht auf die Wörter seiner Überschrift. Ein Blockverweis benennt eine Aussage, ein Seitenverweis ein Thema. Er überschreitet keine Wiki-Grenze: Ein anderes Wiki wird über seine URL erreicht, und ein Verweis dorthin verhält sich wie ein externer Link, denn ein Verweis über die Grenze hinweg würde in Wikis aufgelöst, die der Leser nicht öffnen kann.