Seite wählen

Content-Wiederverwendung planen in DITA

von

Wissen

Was ab Januar 2027 mit der Maschinenverordnung auf Betriebsanleitungen zukommt — und wie du vom Word-Grab zu strukturierter Doku kommst. RoboHelp, FrameMaker, DITA und SharePoint als Doku-Plattform. Mit Skizzen, Tabellen und ehrlichen Faustregeln.

Beratung

MVO-Readiness-Check, Migration aus dem Word-Grab, Doku-Plattform auf SharePoint und Purview. Auch als Akut-Einsatz, wenn RoboHelp-Ausgabe oder Übersetzungsworkflow klemmt. Bewertete Befunde und Click-by-Click-Aktionsplan statt Folienschlacht.

Schulungen

Eintägige DITA/FrameMaker-Schulung online — kompakt, hands-on, mit echten Übungen. Inhouse-Workshops zu Doku-Prozessen und Doku auf Microsoft 365, auch als Begleitung zur laufenden Umstellung

Content-Wiederverwendung planen in DITA

Vier Ebenen, drei Mechanismen – und die Governance, die das Ganze zusammenhält

Content-Wiederverwendung planen: conref, keys und Varianten

Wiederverwendung ist das Versprechen, mit dem sich strukturierte Dokumentation verkauft: einmal schreiben, überall nutzen, einmal korrigieren, überall aktuell. Das Versprechen stimmt – und es ist zugleich die Stelle, an der die meisten Redaktionen sich selbst ein Bein stellen. Denn Wiederverwendung ist kein Schalter, den man umlegt, sondern eine Entscheidung, die man an tausend Stellen trifft. Wer sie ohne Regeln trifft, baut binnen zwei Jahren ein Beziehungsgeflecht, das niemand mehr durchschaut – und in dem sich niemand mehr traut, etwas zu ändern.

Das Muster ist immer dasselbe: Am Anfang steht Begeisterung. Der Warnhinweis wird zentral abgelegt und überall eingebunden, der Produktname wird zur Variablen, die Varianten werden über Bedingungen gesteuert. Alles funktioniert, alles fühlt sich elegant an. Zwei Jahre später steht in einem Topic ein Absatz, der aus drei Quellen zusammengesetzt ist, mit vier Bedingungen versehen und über zwei Schlüssel aufgelöst wird – und die neue Kollegin fragt, warum in der englischen Servicevariante die Hälfte fehlt. Niemand weiß es.

Dieser Artikel erklärt die Mechanismen verständlich – die Ebenen der Wiederverwendung, den Unterschied zwischen conref und keys, die drei Wege zur Variante – und widmet den zweiten Teil dem, was in Werkzeugschulungen fehlt: der Governance, die verhindert, dass aus einem Werkzeug ein Dickicht wird.

★ Fakten kompakt

  • Wiederverwendung findet auf vier Ebenen statt: Publikation (Maps), Topic, Block (Absätze, Warnhinweise) und Wert (Namen, Versionen)
  • conref bindet Inhalt direkt ein: Der Verweis zeigt auf eine konkrete Quellstelle, alle Einbindungen ändern sich mit ihr
  • keys adressieren über einen Namen: Das Topic nennt nur den Schlüssel, die Map legt fest, was er bedeutet – je Publikation unterschiedlich
  • Varianten entstehen auf drei Wegen: Auswahl über die Map, Bedingungen im Text oder Auflösung über keys
  • Prüfreihenfolge: erst Map, dann Wert, erst zuletzt Bedingung – das hält den Bestand pflegbar
  • Governance ist Pflicht, nicht Kür: begrenzte Bedingungsliste, benanntes Bausteinlager, benannte Verantwortung
  •  

    Warum reicht es nicht, einfach zu kopieren? Weil Kopien keine Beziehung haben. Eine kopierte Passage ist ab dem Moment des Einfügens ein eigenständiges Leben: Sie wird unabhängig geändert, unabhängig übersetzt, unabhängig vergessen. Nach drei Jahren existieren vier Fassungen desselben Warnhinweises, und keine ist als solche erkennbar – der Unterschied zwischen ihnen ist ein historischer Zufall, kein Redaktionsentscheid. Genau diese stille Divergenz ist das Problem, gegen das Wiederverwendung antritt; die eingesparte Tipparbeit ist nur der sichtbarste Nebeneffekt.

    Die vier Ebenen der Wiederverwendung

    Bevor es um Mechanismen geht, lohnt die Sortierung nach Ebenen – denn Wiederverwendung ist nicht eine Sache, sondern vier, mit sehr unterschiedlichem Verhältnis von Nutzen zu Komplexität. Die gröbste Ebene ist die Publikation: Ganze Kapitelstrukturen werden in mehreren Ausgaben verwendet, etwa der komplette Sicherheitsteil in allen Handbüchern einer Baureihe. Technisch ist das eine Teil-Map, die in mehrere Publikationen eingehängt wird; konzeptionell ist es der billigste große Hebel, weil eine einzige Verknüpfung dutzende Seiten abdeckt.

    Die zweite Ebene ist das Topic – der Standardfall und für die meisten Redaktionen der wichtigste. Dieselbe Sicherheitseinweisung erscheint im Handbuch, in der Servicekarte und in der Schulungsunterlage; sie existiert einmal, wird einmal gepflegt und dreimal ausgeliefert. Hier braucht es keine speziellen Mechanismen, nur eigenständig geschriebene Topics und Maps, die sie einhängen – genau das, was der Beitrag zum topic-basierten Schreiben als Grundlage beschreibt. Wer nur diese beiden Ebenen nutzt, hat den Großteil des wirtschaftlichen Nutzens bereits eingesammelt, ohne nennenswerte Komplexität. Diese Beobachtung ist wichtiger, als sie klingt: Sie erlaubt, den größten Teil des Nutzens einzusammeln, ohne die Risiken einzukaufen, um die es im zweiten Teil dieses Artikels geht.

    Interessant und riskant wird es auf den feineren Ebenen. Ebene drei ist der Block: einzelne Absätze, Handlungsschritte oder Warnhinweise, die an einer Stelle gepflegt und in vielen Topics eingebunden werden. Das ist die Domäne von conref und verwandten Mechanismen – mächtig, weil ein Warnhinweis in zwanzig Topics mit einer Änderung aktualisiert wird, und pflegeintensiv, weil zwanzig Abhängigkeiten entstehen, die niemand sieht, wenn man ins Topic schaut. Und Ebene vier ist der Wert: Produktnamen, Versionsangaben, Modellbezeichnungen als Variablen oder Schlüssel statt als getippter Text. Diese Ebene ist der billigste Einstieg mit dem sichtbarsten Sofortnutzen – wer schon einmal ein Produkt umbenannt hat, weiß, warum.

    Eine Anmerkung zum wirtschaftlichen Effekt, weil er oft falsch eingeschätzt wird: Der größte Hebel der Wiederverwendung liegt nicht beim Schreiben, sondern bei der Übersetzung. Ein Baustein, der in fünf Publikationen erscheint, wird einmal übersetzt statt fünfmal – und weil es tatsächlich derselbe Text ist, greift das Translation Memory sauber statt an leicht abweichenden Formulierungen zu scheitern. Bei mehreren Sprachen multipliziert sich dieser Effekt mit jeder Zielsprache. Wer die Wirtschaftlichkeit rechnen will, sollte deshalb bei der Übersetzungsrechnung anfangen, nicht bei den Schreibstunden.

    Vier Ebenen der DITA-Wiederverwendung: Publikation, Topic, Block und Wert – von grob nach fein erklärt.

    Abb.: Vier Ebenen von grob nach fein – der Nutzen ist oben am günstigsten zu haben, die Komplexität wächst nach unten.

    Bevor es an die Mechanismen geht, ein Wort zur Terminologie – denn sie ist die stille Voraussetzung von allem, was hier folgt. Wiederverwendung funktioniert nur, wenn dieselbe Sache überall gleich heißt: Ein Baustein, der von der „Abdeckung" spricht, passt nicht in ein Topic, das dieselbe Komponente „Haube" nennt. Und das Translation Memory erkennt Wiederholungen nur, wenn sie tatsächlich Wiederholungen sind. Wer Wiederverwendung plant und die Terminologie nicht im Griff hat, baut auf Sand — wie ein pragmatischer Einstieg in die Terminologiearbeit aussieht, behandelt ein eigener Beitrag dieser Serie.

    conref und keys: zwei Mechanismen, zwei Denkweisen

    Kommen wir zu den beiden Begriffen, die in jeder DITA-Diskussion fallen und die man einmal sauber getrennt haben sollte. Der erste ist conref – Content Reference. Die Idee: Ein Inhaltsbaustein existiert an einer Stelle, und andere Topics binden ihn ein, statt ihn zu kopieren. Beim Erzeugen der Ausgabe holt das System den Inhalt von der Quelle und setzt ihn ein. Der Effekt ist eine einzige Wahrheit: Ändert sich der Warnhinweis in der Quelle, ändert er sich in allen zwanzig Einbindungen mit, ohne dass jemand nachziehen muss.

    Der zweite Begriff ist der Schlüssel – key. Die Denkweise ist eine andere und eine Abstraktionsebene höher: Das Topic nennt nicht mehr die Quelle, sondern nur einen Namen – etwa „Produktname" oder „Sicherheitshinweis-Netzspannung". Was dieser Name bedeutet, legt nicht das Topic fest, sondern die Map, in der es verwendet wird. Damit kann dasselbe Topic in Publikation A einen anderen Wert liefern als in Publikation B, ohne dass am Topic irgendetwas geändert wird. Das ist der Unterschied in einem Satz: conref bindet Inhalt, keys binden Namen – und wer variieren will, braucht Namen.

    Daraus folgt die Zuordnung in der Praxis. conref ist richtig für Inhalte, die überall identisch sein müssen und sollen: normierte Warnhinweise, Standardschritte, Konformitäts- und Haftungstexte – alles, wo Abweichung ein Fehler wäre. Keys sind richtig für alles, was je nach Zusammenhang anders lauten soll: Produkt- und Modellnamen, variantenabhängige Werte, Verweisziele, die in verschiedenen Publikationen auf verschiedene Topics zeigen. Beide lassen sich übrigens kombinieren – ein über einen Schlüssel adressierter Inhaltsbaustein ist der flexibelste und zugleich abstrakteste Fall. Für den Einstieg gilt: erst das eine verstehen, dann das andere, und die Kombination erst, wenn ein konkreter Bedarf sie erzwingt. Abstraktion auf Vorrat ist in diesem Themenfeld die verlässlichste Quelle späterer Verwirrung.

    Eine Feinheit verdient noch Erwähnung, weil sie in der Praxis oft gebraucht wird: Eingebundene Inhalte müssen nicht immer eins zu eins übernommen werden. Der Standard kennt Mechanismen, mit denen sich ein Bereich einbinden und dabei an definierten Stellen ergänzen oder ersetzen lässt – etwa eine Standard-Handlungsfolge, bei der ein Schritt produktspezifisch abweicht. Das ist mächtig und die vorletzte Stufe vor dem Zuviel: Wer beginnt, eingebundene Bausteine an mehreren Stellen zu überschreiben, sollte prüfen, ob nicht zwei getrennte Bausteine ehrlicher wären. Als Faustregel gilt auch hier: Ein eingebundener Baustein mit einer Anpassung ist elegant, einer mit vier ist ein Rätsel.

    Vergleich der DITA-Mechanismen conref (Inhalt einbinden) und keys (über Namen adressieren) mit Einsatzgebieten.

    Abb.: Direkte Bindung gegen Adressierung über Namen – die Wahl entscheidet, ob Inhalt fix oder variabel ist.

    Drei Wege zur Variante

    Damit zur Frage, an der sich die Pflegbarkeit entscheidet: Wie bildet man Varianten ab? Es gibt drei Wege, und ihre Reihenfolge in der Prüfung ist wichtiger als ihre technische Beherrschung. Weg eins ist die Auswahl über die Map: Variante A bekommt die Topics eins, zwei und drei, Variante B die Topics eins, zwei und vier. Kein Topic wird angefasst, keine Bedingung gesetzt – die Publikationen unterscheiden sich schlicht in dem, was eingehängt ist. Wo ganze Themen entfallen oder hinzukommen, ist das der sauberste und einfachste Weg, und er sollte immer zuerst geprüft werden.

    Weg zwei ist die Auflösung über Schlüssel: Der Text nennt „Produktname", und jede Map belegt diesen Namen mit dem passenden Wert. Das passt für durchgängige Werte und Verweisziele, die sich variantenweise unterscheiden, ohne dass der Text selbst anders wird. Der Charme: Das Topic bleibt lesbar und allgemeingültig, die Variantenlogik lebt an einer einzigen, überschaubaren Stelle. Weg drei ist die Bedingung im Text: Passagen werden markiert und je Ausgabe ein- oder ausgeblendet. Das ist der mächtigste Weg – und der einzige, der wirklich in den Textkörper eingreift. Er passt bei kleinen Abweichungen innerhalb gleicher Themen: der zusätzliche Schritt, der nur bei der Variante mit Absaugung nötig ist.

    Die Prüfreihenfolge – erst Map, dann Wert, erst zuletzt Bedingung – ist die vielleicht wichtigste Faustregel dieses Artikels. Sie klingt bürokratisch und spart Jahre später enorm viel Ärger, denn Bedingungen sind der Mechanismus, der Topics unlesbar macht: Ein Topic mit vier verschachtelten Bedingungen liest sich für den Autor nicht mehr wie ein Text, sondern wie ein Programm mit Verzweigungen. Wer stattdessen erst fragt „Lässt sich das über die Map lösen?" und dann „Geht es über einen Wert?", greift deutlich seltener zur Bedingung – und wenn, dann bewusst.

    Und ein vierter Weg gehört ausdrücklich dazu, auch wenn er in Werkzeugschulungen selten vorkommt: die getrennten Topics. Wenn zwei Varianten sich zu großen Teilen unterscheiden, ist das Bedingungsgeflecht kein Fortschritt, sondern eine Verschleierung – zwei eigenständige Topics sind dann lesbarer, prüfbarer und in der Summe billiger. Die Faustregel aus der Praxis: Bis etwa zwanzig Prozent Abweichung lohnt die gemeinsame Quelle mit Bedingungen; darüber wird die Trennung attraktiver. Wiederverwendung ist ein Mittel, kein Ziel – und diese Entscheidung ist redaktionelle Urteilskraft, die kein Werkzeug abnimmt.

    Drei DITA-Varianten-Wege: Auswahl über Map, Bedingungen im Text und Auflösung über keys – mit Empfehlungen.

    Abb.: Drei Wege zur Variante – die Reihenfolge der Prüfung entscheidet, wie lesbar der Bestand in fünf Jahren ist.

    Fall

    Empfohlener Weg

    Wo die Grenze liegt

    Ganzes Kapitel entfällt in Variante B

    Auswahl über die Map

    Nur bei klar abgrenzbaren Themen

    Produktname unterscheidet sich

    Schlüssel je Publikation belegen

    Braucht saubere Namenskonventionen

    Ein zusätzlicher Schritt bei Ausstattung X

    Bedingung im Text

    Ab drei Bedingungen je Topic wird es unlesbar

    Identischer Warnhinweis in 20 Topics

    Block per conref einbinden

    Änderung wirkt überall – Wirkung vorher prüfen

    Verweisziel unterscheidet sich je Ausgabe

    Schlüssel statt direktem Verweis

    Eine Abstraktionsebene mehr im Kopf

    Zwei Varianten weichen fast überall ab

    Getrennte Topics statt Bedingungswust

    Wiederverwendung ist kein Selbstzweck

     

    Der Preis: was Wiederverwendung kostet

    Jetzt die ehrliche Seite, die in Werkzeugpräsentationen fehlt. Jede Wiederverwendungsbeziehung ist eine Abhängigkeit, und Abhängigkeiten haben Kosten. Die erste ist die unsichtbare Wirkung: Wer einen zentral abgelegten Warnhinweis ändert, ändert ihn in zwanzig Topics – auch in denen, an die er gerade nicht denkt. Das ist genau der gewünschte Effekt und zugleich das Risiko, wenn eine Änderung nur für einen Zusammenhang gedacht war. Ohne den Blick auf die Verwendungsstellen wird aus einer Korrektur unbemerkt eine Änderung an Stellen, wo sie nicht passt.

    Die zweite Kostenstelle ist die Lesbarkeit für Autoren. Ein Topic, das zur Hälfte aus eingebundenen Blöcken besteht, mit Schlüsseln arbeitet und mehrere Bedingungen trägt, ist beim Schreiben kein Text mehr – man sieht Platzhalter statt Inhalt und muss sich die Ausgaben vorstellen. Moderne Werkzeuge helfen mit Vorschaufunktionen, aber die kognitive Last bleibt. Und die dritte Kostenstelle ist die Prüfbarkeit: Was in fünf Varianten unterschiedlich zusammengesetzt wird, muss auch in fünf Varianten geprüft werden – eine Stichprobe in der Hauptausgabe sagt nichts über die anderen. Gerade bei sicherheitsrelevanten Inhalten ist das ein Punkt, den man nicht überspringen darf.

    Daraus folgt die Grundhaltung, die diesen Artikel trägt: Wiederverwendung ist kein Selbstzweck, sondern ein Werkzeug mit Betriebskosten. Der Nutzen ist real – gerade bei mehreren Sprachen, weil wiederverwendete Bausteine nur einmal übersetzt werden und das Translation Memory sauber greift. Aber er rechnet sich nur, wenn die Beziehungen überschaubar bleiben. Zwei Varianten, die zu neunzig Prozent voneinander abweichen, gehören nicht in ein Topic mit Bedingungsgeflecht, sondern in zwei Topics. Diese Entscheidung zu treffen, ist redaktionelle Urteilskraft – kein Werkzeug nimmt sie ab. Und sie fällt leichter, wenn man sich klarmacht, dass zwei gepflegte Topics kein Rückschritt sind, sondern manchmal schlicht die ehrlichere Abbildung der Wirklichkeit.

    Ein Sonderfall verdient eigene Aufmerksamkeit: sicherheitsrelevante Inhalte. Sie sind die besten Kandidaten für Wiederverwendung – normierte Warnhinweise sollen überall identisch lauten, und genau das leistet ein zentral gepflegter Baustein zuverlässiger als menschliche Sorgfalt. Zugleich sind sie die Inhalte, bei denen ein unbemerkter Nebeneffekt am teuersten wird. Deshalb gilt hier die Wirkungsprüfung nicht als Empfehlung, sondern als Pflicht, und die Freigabe solcher Bausteine gehört an eine benannte Stelle: Wer den Standard-Warnhinweis ändert, ändert das Produkt in seiner Gesamtheit — das ist keine Redaktionsroutine, sondern eine dokumentierte Entscheidung.

    Auch für das Review verschiebt sich etwas, und das wird beim Einstieg gern übersehen. Ein Fachprüfer, der ein Topic im Autorenwerkzeug sieht, liest möglicherweise nicht das, was in seiner Ausgabe erscheint – Bedingungen blenden aus, Bausteine sind Platzhalter, Schlüssel unaufgelöst. Deshalb gehört das Review bei ausgeprägter Wiederverwendung an die erzeugte Ausgabe statt an die Quelle: geprüft wird, was der Leser sieht, und zwar je relevanter Variante. Das klingt nach mehr Aufwand und ist in Wahrheit die einzige Prüfung, die überhaupt aussagekräftig ist.

    Governance: die Regeln gegen den Wildwuchs

    Womit wir beim eigentlichen Thema wären. Sechs Regeln reichen aus, um Wiederverwendung dauerhaft beherrschbar zu halten – und sie kosten zusammen weniger Aufwand, als das Aufräumen eines einzigen entgleisten Bestands. Regel eins ist die Zwei-Bedarfs-Regel: Wiederverwendet wird, was zweimal gebraucht wurde, nicht was vielleicht irgendwann zweimal gebraucht werden könnte. Vorrats-Abstraktion ist der häufigste Einstiegsfehler; sie produziert blasse, allgemeine Texte und Beziehungen ohne Nutzen. Regel zwei ist das benannte Bausteinlager: Wiederverwendete Blöcke liegen an einem definierten Ort mit klarer Benennung – nicht verstreut in irgendwelchen Topics, aus denen dann jeder referenziert, was er zufällig findet.

    Regel drei ist die wirksamste: eine begrenzte, dokumentierte Bedingungsliste. Welche Bedingungswerte gibt es – Produktvarianten, Zielgruppen, Ausgabekanäle –, wer darf neue anlegen, und wofür ist welcher gedacht? Ohne diese Liste wächst die Zahl der Bedingungen mit jedem Autor und jedem Sonderfall; nach zwei Jahren existieren dreißig Werte, von denen die Hälfte dasselbe meint und ein Drittel tot ist. Mit ihr ist Wildwuchs praktisch ausgeschlossen, weil neue Werte einen bewussten Schritt erfordern. Regel vier ist die Änderung mit Wirkungsblick: Vor jeder Änderung an einem wiederverwendeten Baustein wird geprüft, wo er überall erscheint – die Werkzeuge können das anzeigen, man muss nur hinschauen.

    Regel fünf ist die benannte Verantwortung: Eine Person pflegt Bausteinlager, Bedingungsliste und Schlüsseldefinitionen. Das sind wenige Stunden im Monat, aber sie müssen einen Namen haben – ohne Besitzer erodiert jedes Regelwerk binnen eines Jahres per Flurfunk. Und Regel sechs ist die jährliche Inventur: einmal im Jahr durchzählen, welche Bausteine nirgends mehr verwendet werden, welche Bedingungen tot sind und welche Schlüssel ins Leere zeigen. Aufräumen ist billiger als Ertragen, und die Inventur ist zugleich der Moment, in dem man merkt, ob die Regeln noch gelebt werden. Ein halber Tag im Jahr genügt dafür — deutlich weniger, als eine einzige Fehlersuche im Geflecht kostet.

    Bei alldem hilft das Werkzeug mehr, als viele nutzen. Verwendungsübersichten zeigen, wo ein Baustein überall erscheint; Vorschaufunktionen blenden Bedingungen so, dass man ein Topic in der Sicht einer bestimmten Variante liest; Prüfläufe finden verwaiste Verweise und nicht aufgelöste Schlüssel. Diese Funktionen sind selten spektakulär beworben und im Alltag Gold wert – wer sie einmal im Team zeigt und in die Review-Routine einbaut, bekommt einen großen Teil der Governance geschenkt. Die Regeln bleiben trotzdem nötig: Werkzeuge zeigen an, was ist; sie entscheiden nicht, was sein soll.

    Sechs DITA-Governance-Regeln: Zwei-Bedarfs-Regel, Bausteinlager, Bedingungsliste, Wirkungsblick, Verantwortung, Inventur.

    Abb.: Sechs Regeln, die zusammen weniger kosten als das Aufräumen eines entgleisten Bestands.

    ⚠ Warnung: Das Bedingungs-Geflecht

    Der klassische Entgleisungspfad verläuft schleichend: Zuerst gibt es zwei Bedingungen für zwei Produktvarianten. Dann kommt eine für die Zielgruppe dazu, dann eine für den Ausgabekanal, dann eine für einen Sonderkunden. Irgendwann trägt ein Absatz drei Bedingungen gleichzeitig, und niemand kann mehr sagen, in welcher Ausgabe er erscheint, ohne alle Kombinationen durchzuspielen. Spätestens jetzt traut sich niemand mehr, etwas zu löschen.

    Zwei Gegenmittel wirken zuverlässig: eine geschlossene Bedingungsliste mit Freigabepflicht für neue Werte – und eine harte Obergrenze je Textstelle, in der Praxis meist zwei Bedingungen. Wer eine dritte braucht, hat mit hoher Wahrscheinlichkeit ein Modellproblem und sollte den Inhalt trennen statt weiter zu verschachteln. Diese Grenze gehört ins Konventionsblatt und ins Review.

     

    ✓ Praxis-Tipp: Die Kandidatenliste vor dem ersten conref

    Bevor irgendein Baustein zentral abgelegt wird, mach eine Kandidatenliste: Welche Textstellen kommen im Bestand tatsächlich mehrfach vor – nachgezählt, nicht geschätzt? Eine Volltextsuche über die häufigsten Standardsätze liefert in einer Stunde eine belastbare Liste, und die überrascht meist in beide Richtungen: Manches, das man für einmalig hielt, steht zwölfmal da; anderes, das zentralisiert werden sollte, existiert genau einmal.

    Aus dieser Liste entsteht das erste Bausteinlager – mit den zehn bis zwanzig Kandidaten, die den größten Effekt haben. Alles andere bleibt vorerst, wie es ist, und wird beim zweiten echten Bedarf nachgezogen. So beginnt Wiederverwendung mit Daten statt mit Begeisterung, und die Sammlung bleibt von Anfang an überschaubar. Die Liste ist übrigens auch das beste Argument gegenüber Skeptikern: Zwölf Fundstellen eines Satzes überzeugen mehr als jede Methodendiskussion.

     

    ℹ Ein typischer Fall aus der Praxis

    Ein typischer Fall sieht so aus: Ein Hersteller von Fördertechnik führt Wiederverwendung ein und startet mit großem Elan – innerhalb eines Jahres entstehen rund achtzig zentral abgelegte Textbausteine und vierzehn Bedingungswerte. Dann kommt der erste Ärger: Eine Anpassung am Standard-Warnhinweis für elektrische Gefahren erscheint plötzlich auch in einer Baureihe ohne elektrischen Antrieb, weil dort derselbe Baustein eingebunden war – bemerkt hat es ein Fachprüfer, glücklicherweise vor der Auslieferung.

    Die Konsequenz war keine Abkehr, sondern eine Nachrüstung an Regeln: die Bedingungswerte wurden von vierzehn auf sechs konsolidiert, das Bausteinlager auf einen definierten Ort mit Namensschema gebracht, eine Obergrenze von zwei Bedingungen je Textstelle festgelegt und die Wirkungsprüfung vor Änderungen zur Pflicht gemacht. Der Aufwand dafür lag bei wenigen Tagen. Seitdem läuft die Wiederverwendung unauffällig — und unauffällig ist bei diesem Thema das höchste Lob.

     

    Der Einstiegsplan: in vier Schritten zur geplanten Wiederverwendung

    Wie führt man das Ganze ein, ohne im ersten Jahr das Geflecht zu produzieren, vor dem dieser Artikel warnt? In vier Schritten, die sich an den Ebenen orientieren. Schritt eins ist die Datenerhebung: die Kandidatenliste aus dem Bestand, nachgezählt statt geschätzt. Dazu die Bestandsaufnahme der Varianten – welche gibt es wirklich, worin unterscheiden sie sich, und wie groß ist der Abweichungsanteil? Diese Zahlen entscheiden über alles Weitere und sind in ein bis zwei Tagen zu haben.

    Schritt zwei ist die Konventionsarbeit, bevor der erste Baustein entsteht: Wo liegt das Bausteinlager, wie werden Bausteine benannt, welche Bedingungswerte gibt es, welche Schlüssel führen wir, und wie lautet die Obergrenze je Textstelle? Eine Seite reicht – aber sie muss vor dem Bauen existieren, denn nachträgliche Konventionen bedeuten immer Umbenennung und Umbau. Schritt drei ist der Einstieg auf den groben Ebenen: Werte und Topics zuerst, weil sie den besten Nutzen bei geringster Komplexität liefern. Wer nur diese beiden Ebenen sauber nutzt, hat oft schon genug getan.

    Schritt vier ist der kontrollierte Ausbau auf die Blockebene – mit den zehn bis zwanzig Kandidaten aus der Liste, nicht mit allem, was theoretisch ginge. Nach einem halben Jahr folgt die erste Zwischenprüfung: Werden die Bausteine tatsächlich genutzt? Ist die Bedingungsliste gewachsen? Hat jemand angefangen, an den Regeln vorbeizuarbeiten? Diese frühe Kontrolle ist wichtiger als jede spätere Aufräumaktion, weil Fehlentwicklungen bei zwanzig Bausteinen in Stunden korrigiert sind und bei zweihundert in Wochen.

    Zum Schluss des Einstiegsplans die Frage nach dem Zeitrahmen: Wie lange dauert das? Die Datenerhebung ein bis zwei Tage, die Konventionsarbeit einen halben, der Einstieg auf Wert- und Topic-Ebene einige Wochen im normalen Betrieb — und der Ausbau auf die Blockebene begleitet danach das Tagesgeschäft, ohne je ein Projekt zu werden. Wichtig ist nur, dass die Reihenfolge stimmt: Wer mit der Blockebene beginnt, weil sie am spektakulärsten wirkt, hat die Governance noch nicht und den Bestand schon verknüpft. Das ist die Kombination, aus der die Geflechte entstehen, von denen dieser Artikel handelt.

    Fazit

    Content-Wiederverwendung ist ein starker Hebel und ein Werkzeug mit Betriebskosten. Die vier Ebenen – Publikation, Topic, Block, Wert – unterscheiden sich stark im Verhältnis von Nutzen zu Komplexität, und der Großteil des wirtschaftlichen Nutzens steckt oben, wo es am einfachsten ist. conref bindet Inhalt, keys binden Namen; Varianten prüft man in der Reihenfolge Map, Wert, Bedingung – und greift damit deutlich seltener zum Mechanismus, der Topics unlesbar macht. Alles Weitere ist Governance: begrenzte Bedingungsliste, benanntes Bausteinlager, Wirkungsblick, Verantwortung mit Namen, jährliche Inventur.

    Der beste erste Schritt kostet eine Stunde: die Kandidatenliste erstellen und nachzählen, was im eigenen Bestand tatsächlich mehrfach vorkommt. Darauf lässt sich planen – alles andere ist Begeisterung ohne Datenlage. Wenn du dabei Unterstützung willst – vom Wiederverwendungskonzept über die Bedingungslogik bis zur Governance, die den Bestand auch nach fünf Jahren pflegbar hält: Genau dabei unterstütze ich dich gern; die Details findest du auf der Beratungsseite zur Technischen Dokumentation.

    Häufige Fragen zur Content-Wiederverwendung

    Was ist der Unterschied zwischen conref und keys?

    conref bindet Inhalt direkt ein: Der Verweis zeigt auf eine konkrete Quellstelle, und alle Einbindungen ändern sich mit ihr – gut für Inhalte, die überall identisch sein müssen, etwa normierte Warnhinweise. Keys adressieren über einen Namen: Das Topic nennt nur den Schlüssel, und die Map legt fest, was er bedeutet – gut für alles, was je nach Publikation anders lauten soll, etwa Produktnamen oder Verweisziele. Merksatz: conref bindet Inhalt, keys binden Namen. Wer variieren will, braucht Namen.

    Wie viele Bedingungen sind zu viele?

    In der Praxis bewährt sich eine Obergrenze von zwei Bedingungen je Textstelle. Wer eine dritte braucht, hat meist ein Modellproblem: Die Inhalte gehören dann getrennt statt weiter verschachtelt. Ebenso wichtig ist die Zahl der Bedingungswerte insgesamt – eine geschlossene, dokumentierte Liste mit Freigabepflicht für neue Werte verhindert zuverlässig den Wildwuchs, bei dem nach zwei Jahren dreißig Werte existieren, von denen die Hälfte dasselbe meint.

    Sollen wir alles wiederverwendbar aufbauen?

    Nein – das ist der häufigste Einstiegsfehler. Vorsorgliche Wiederverwendbarkeit macht Texte blass und allgemein und erzeugt Beziehungen ohne Nutzen. Die bewährte Regel lautet: Wiederverwendet wird, was zweimal gebraucht wurde, nicht was vielleicht irgendwann zweimal gebraucht werden könnte. Der praktische Einstieg ist eine Kandidatenliste aus dem Bestand – nachgezählt, welche Textstellen tatsächlich mehrfach vorkommen –, und daraus die zehn bis zwanzig mit dem größten Effekt.

    Was passiert, wenn wir einen zentralen Baustein ändern?

    Er ändert sich überall, wo er eingebunden ist – das ist der gewünschte Effekt und zugleich das Risiko. Deshalb gehört vor jede Änderung der Blick auf die Verwendungsstellen: Die Werkzeuge können anzeigen, wo ein Baustein überall erscheint. Sonst wird aus einer Korrektur, die nur für einen Zusammenhang gedacht war, unbemerkt eine Änderung an Stellen, wo sie nicht passt – gerade bei Sicherheitsinhalten ein Fehler mit Folgen. Diese Wirkungsprüfung ist eine Minute Arbeit und gehört zur Pflicht.

    Brauchen wir für Wiederverwendung zwingend DITA?

    Nein. Die Ebenen Publikation und Topic funktionieren in jedem topic-basierten Werkzeug, und auch Help-Authoring-Werkzeuge bringen Snippets, Variablen und Bedingungen für die feineren Ebenen mit. DITA standardisiert diese Mechanismen und ergänzt mit dem Schlüsselkonzept eine besonders saubere Trennung – aber die Governance-Fragen sind in allen Werkzeugen dieselben. Wer sie nicht beantwortet, bekommt auch im Standard ein Geflecht; wer sie beantwortet, kommt auch mit einfacheren Mitteln weit.

     

    Interne Links: Pillar „Technische Dokumentation" (/technische-dokumentation/) · Topic-basiertes Schreiben (/topic-basiertes-schreiben/) · Terminologie-Management ohne teure Tools starten (/terminologie-management-einstieg/) · Single-Source-Publishing (/single-source-publishing/) · Beratung (/technische-dokumentation-beratung/)