Themenbasiertes Authoring vs. modulares Authoring

Dies ist eine komplexe Frage – kompliziert genug, dass ich ein Buch darüber geschrieben habe: Every Page is Page One: Topic-based Writing for Technical Communication and the Web von XML Press ( https://xmlpress.net/publications/eppo/ ) .

Im Zentrum der Verwirrung steht die Unklarheit darüber, was das Wort „Thema“ bedeutet.

Lange Zeit haben wir mit dem Wort "Thema" eine kurze, in sich geschlossene Information zu einem einzelnen Thema verstanden, zum Beispiel ein Hilfethema. Ein Thema war eine Verbrauchseinheit. Ein Rezept ist ein Thema. Ein Wikipedia-Eintrag ist ein Thema. Eine Manpage ist ein Thema.

In der Zwischenzeit entwickelte Robert Horn eine Theorie der Informationsabbildung, die behauptete, man könne das Schreiben verbessern, indem man ein Dokument in Abschnitte von einem von sechs (ursprünglich sieben) Informationstypen aufteilt: Verfahren, Prozess, Prinzip, Konzept, Struktur und Fakten. Bei der Informationszuordnung war ein Dokument eine Karte, die aus Blöcken verschiedener Informationstypen bestand. Das war nicht ganz modulares Schreiben – es war eher eine Frage des modularen Designs – aber es führte die Idee ein, dass ein großes Dokument aus kleineren einzelnen Teilen bestehen könnte. ( https://en.wikipedia.org/wiki/Information_mapping )

Etwa zur gleichen Zeit führte John Carroll vom MIT eine Reihe von Studien darüber durch, wie Menschen Informationen verwenden, die zeigten, dass die Art systematischer technischer Handbücher, die üblicherweise in den 80er Jahren geschrieben wurden, nicht sehr gut funktionierten, weil die Menschen sie nicht systematisch verwendeten. Stattdessen neigten sie dazu, in und aus verschiedenen Informationsquellen zu springen, angetrieben von ihren unmittelbaren Aufgaben. Carroll entwickelte eine Theorie des Informationsdesigns namens Minimalismus. Unter anderem forderte diese Theorie die Autoren auf, kleinere Informationseinheiten zu erstellen, jede Einheit mit der Erwartung zu gestalten, dass Benutzer zufällig darauf zugreifen würden, und sich auf Experimente und Fehlerbeseitigung in eher langen Studiensitzungen zu konzentrieren.

Studien bei Xerox PARK führten dann zur Theorie der Informationssuche, die besagt, dass Menschen nach Informationen suchen, wie wilde Tiere nach Nahrung suchen – indem sie Informationen wittern und versuchen, den Kalorienverbrauch zu minimieren. Diese Theorie bestätigte Carrolls Ergebnisse. ( https://www.nngroup.com/articles/information-scent/ )

Das Web verbessert die Informationssuche der Menschen erheblich und verändert die Art und Weise, wie Menschen arbeiten und lernen. Stack Overflow ist ein Paradebeispiel für diesen Trend. Es erhöht die Wichtigkeit, kleine unabhängige Themen zu erstellen, die mein Buch „Every Page is Page One“ (EPPO)-Themen nennt. Es verringert auch die Priorität, technische Handbücher im Lehrbuchstil zu erstellen. Dieser Ansatz ist eine Bedeutung von „thematischem“ Schreiben und bedeutet lediglich, dass man eher kurze unabhängige Werke schreibt als lange integrierte.

Gleichzeitig hatten die Zunahme von Produktvariationen und die Verkürzung der Produktveröffentlichungszyklen dazu geführt, dass die technischen Kommunikationsabteilungen Schwierigkeiten hatten, Schritt zu halten. Daher bestand ein zunehmendes Interesse daran, vorhandene Inhalte so weit wie möglich wiederzuverwenden, was zur Entwicklung und zunehmenden Akzeptanz von DITA führte. DITA basierte sein Datenmodell auf Information Mapping, obwohl es den Basissatz von Informationstypen von sechs auf drei reduzierte: Concept, Task und Reference. (Mit DITA können Sie über einen Prozess namens Spezialisierung weitere Typen erstellen.)

Hier begann die Verwirrung. Während Information Mapping diese Einheiten „Blöcke“ nannte, entschied sich DITA dafür, sie „Themen“ zu nennen. Wie bei der Informationszuordnung ist ein Dokument in DITA eine Karte. In DITA ist ein Dokument jedoch eine Karte von Themen , keine Blöcke. In DITA bedeutete „themenbasiertes Authoring“ daher das isolierte Schreiben diskreter wiederverwendbarer Teile eines Dokuments. Während ein Thema im Sinne von Every Page is Page One die Einheit ist, die dem Leser geliefert wird, ist ein Thema im Sinne von DITA die Einheit, die der Autor schreibt, und oft muss es mit anderen Einheiten kombiniert werden, um etwas Nützliches für den Leser zu ergeben.

Im EPPO-Sinne ist beispielsweise ein Rezept ein Thema. Beim DITA-Ansatz besteht ein Rezept jedoch aus einem Konzeptthema (der Einführung), einem Referenzthema (der Zutatenliste) und einem Aufgabenthema (der Zubereitungsanleitung), die durch eine Karte verbunden sind. (Nicht jeder DITA-Anwender würde es so weit treiben, aber es veranschaulicht das Prinzip.) Somit haben wir zwei unterschiedliche Bedeutungen von „Thema“ und zwei unterschiedliche Bedeutungen von „thematischem Schreiben“.

Es wäre hilfreich, wenn der Begriff „modular“ verwendet würde, um zwischen diesen beiden Formen des themenbasierten Schreibens zu unterscheiden, aber leider wird „modulares Schreiben“ auch auf diese zwei unterschiedlichen Arten verwendet.

Ich vermute, dass diese anhaltende Verwirrung darauf zurückzuführen ist, dass Sie Ihre kurzen Artikel mit ziemlicher Sicherheit nicht aus separat verwalteten Blöcken aufbauen, wenn Sie themenbasiertes Schreiben im Sinne von „Jede Seite ist Seite Eins“ betreiben. Die Leute, die das machen, sind diejenigen, die größere Werke zusammenstellen. Beide Gruppen von Praktizierenden verwenden dieselben Begriffe, um zu beschreiben, was sie tun, aber sie tun sehr unterschiedliche Dinge.

Ich habe den Begriff „Jede Seite ist Seite Eins“ geprägt, um zu versuchen, die Verwirrung zu verringern oder den Leuten zumindest eine Möglichkeit zu geben, genauer zu sein, wenn sie diese Begriffe verwenden.

Das themenbasierte Authoring ist eigentlich eine besondere Form des modularen Authoring. Modulares Authoring ist am häufigsten in technischen Arbeiten anzutreffen, bezieht sich jedoch auf jede Schreibpraxis, bei der verschiedene Autoren Teile eines bestimmten Projekts basierend auf ihrem Fachwissen und ihrer Fähigkeit erhalten, diesen Teil am effektivsten zum Tragen zu bringen.

Themenbasiertes Verfassen ist eine Modulation, die auf dem Thema basiert, in dem der Autor Experte ist. Es gibt andere Möglichkeiten, ein Schreibprojekt zu modulieren, bei dem Aufgaben aufgeschlüsselt werden, beispielsweise basierend auf den verschiedenen Umgebungen, die abgedeckt werden müssen (die Umgebung kann je nach Thema physisch oder regulatorisch sein) oder um Unterschiede in der Arbeitszeit abzudecken, wenn Aufgaben in verschiedenen Schichten unterschiedlich sind.

Unter Verwendung eines Luftfahrthandbuchs als Beispiel im themenbasierten Ansatz können Autoren gebeten werden, ihre Meinung zu bestimmten Vorgängen, dem Be- und Entladen von Gütern, den "richtigen" Einstellungen für den Betrieb eines bestimmten Flugzeugs und der Navigation im Falle eines Instrumentenausfalls abzugeben usw. Alternativ kann die Arbeit über mehrere Regulierungsumgebungen hinweg moduliert werden, wobei Autoren gebeten werden, ihre schriftliche Meinung zu einer Reihe von Themen innerhalb eines bestimmten Regulierungsraums abzugeben, z. B. wenn ein Autor alle Betriebsstandards in der EU abdeckt, ein anderer Russland und ein Drittel für Nordamerika.