Context Card
Every Page is Page One vs. semantische Dokumentation
Ist Every Page is Page One eine Form semantischer Dokumentation?
Die kurze Antwort
Nein – es sind zwei eigenständige Modelle, die sich ergänzen. Every Page is Page One, beschrieben von Mark Baker, ist ein Schreibmodell: Jede Seite muss als erste Seite funktionieren, ihren Kontext nennen und reich verlinken. Semantische Dokumentation ist ein Modell der Darstellung: Markup und Metadaten geben maschinenlesbar an, worum es im Inhalt geht. Semantische Metadaten können den Kontext einer EPPO-Seite für Systeme lesbar machen.
Für: Technische Redakteure, Informationsarchitekten und Content-Strategen
Das Wichtigste
- EPPO betrifft, wie eine Seite geschrieben und verlinkt wird; semantische Dokumentation, wie Bedeutung codiert wird.
- Baker nennt sieben Merkmale, darunter „nennt seinen Kontext“ und „verlinkt reichhaltig“.
- Semantische Dokumentation nutzt Markup, Metadaten und Vokabulare wie Taxonomien und Ontologien.
- Den Kontext, den eine EPPO-Seite im Text nennt, kann man zusätzlich als Metadaten erfassen.
- Keines der Modelle hängt von einem bestimmten Werkzeug oder einer Auszeichnungssprache ab.
Der Zusammenhang
Schreiben vs. Darstellen
Eine Every-Page-is-Page-One-Seite ist eigenständig, hat einen spezifischen Zweck, folgt ihrem Typ, nennt ihren Kontext, setzt qualifizierte Leser voraus, bleibt auf einer Ebene und verlinkt reichhaltig. Das sind Kriterien für Redakteure, nicht für Software.
Semantische Dokumentation codiert Bedeutung: Metadaten klassifizieren ein Topic nach Produkt, Komponente, Lebenszyklusphase und Zielgruppe, mit Werten aus einer Taxonomie oder Ontologie, die ein Informationsmodell festlegt. Auslieferungsstandards wie iiRDS beschreiben Topics auf diese Weise.
Wo sie sich treffen
Eine EPPO-Seite nennt ihren Kontext für Menschen; semantische Metadaten nennen denselben Kontext für Systeme. Zusammen kann ein Auslieferungsportal oder ein Knowledge Graph die passende Seite auswählen und Links entlang definierter Beziehungen erzeugen. Die EPPO Projects dieser Website zeigen Seiten, die ihren Kontext ausdrücklich nennen.
Fragen, die sich daran anschließen
- Setzt EPPO XML oder DITA voraus?
- Nein. EPPO ist ein Schreibmodell und lässt sich in jeder Redaktions- oder Publikationsumgebung anwenden.
- Können semantische Metadaten den Kontext im Text ersetzen?
- Nicht für Menschen. Metadaten dienen Systemen; die Seite muss ihren Lesern trotzdem sagen, wohin sie gehört.
Quellen
Prüfprotokoll und Änderungen
Jede Context Card wird vor der Veröffentlichung und bei jeder Änderung erneut anhand ihrer Quellen geprüft; das Datum unter der Autorenzeile ist die letzte Prüfung. Korrekturen (etwas war falsch) und Ergänzungen (etwas fehlte) stehen unten mit Datum und Uhrzeit (deutsche Zeit). Tippfehler, Formatierung und Link-Korrekturen werden nicht aufgeführt.
Geprüft
Seit der Veröffentlichung keine Korrekturen oder Ergänzungen.