Überblick
Mit Verzweigungen in Adobe Experience Manager Guides können Sie mehrere Verzweigungen außerhalb der erstellen und verwalten damit eine DITA-Zuordnung parallel an verschiedenen Dokumentationsversionen arbeiten kann. Jede Verzweigung ermöglicht es Autorinnen und Autoren, Inhaltsänderungen unabhängig zu verwalten, ohne den entsprechenden Inhalt in anderen Verzweigungen zu beeinflussen.
Mit Verzweigungen können mehrere Teams gleichzeitig an verschiedenen Versionen, Funktionen oder Fehlerbehebungen arbeiten, die mit derselben DITA-Zuordnung verknüpft sind. Sie können Änderungen aus einer Verzweigung mit der Standardverzweigung (main) zusammenführen, wenn die Aktualisierungen fertig sind.
Funktionsweise von Verzweigungen
Sie können eine Verzweigung aus der Haupt oder einer vorhandenen Verzweigung einer DITA-Zuordnung erstellen. Nachdem Sie eine Verzweigung erstellt haben, können Sie zu ihr wechseln und mit der Bearbeitung der Karte und ihres Inhalts beginnen. Sie können auch Inhalte aus der ausgewählten Verzweigung veröffentlichen oder Änderungen in main zusammenführen, wenn sie bereit sind.
Nehmen wir zum Beispiel eine DITA-Zuordnung mit dem Namen install-the-lift.ditamap, die Installationsanweisungen für ein Produkt enthält. Ihr Dokumentations-Team kann zwei Verzweigungen dieser Zuordnung aus main erstellen:
- Version 1: Team A pflegt bestehende Installationsanweisungen und behandelt Fehlerbehebungen.
- Version 2: Team B entwickelt Installationsanweisungen für neue Funktionen.
Beide Teams können unabhängig voneinander an ihren jeweiligen Zuordnungsverzweigungen arbeiten, ohne die Änderungen der anderen zu beeinflussen.
Wenn Sie eine Verzweigung einer DITA-Zuordnung erstellen, kopiert Experience Manager Guides die referenzierten Themen der Zuordnung nicht automatisch in die neue Verzweigung. Unveränderte Themen werden aus dem Quellzweig oder dem Standardzweig (Main) gelesen. Ein Thema wird nur dann in die neue Verzweigung kopiert, wenn Sie es bearbeiten und in dieser Verzweigung speichern.
Beispielsweise verweist eine DITA-Zuordnung auf 100 Themen, und das Repository enthält 50 zusätzliche Themen, auf die die Zuordnung nicht verweist. Wenn Sie eine neue Verzweigung erstellen (Version 1.0), werden alle 100 referenzierten Themen automatisch Teil von Version 1.0, auch wenn keines von ihnen bearbeitet wird. Die 50 nicht referenzierten Themen werden nicht automatisch Teil der neuen Verzweigung. Wenn Sie 10 davon bearbeiten, werden nur diese 10 Teil von Version 1.0. Die verbleibenden 40 unveränderten Themen werden weiterhin von der Standardverzweigung (Hauptverzweigung) aus verwendet.
Die wichtigsten Vorteile
Das Arbeiten mit einer Verzweigung in Experience Manager Guides bietet die folgenden Vorteile:
- Isolierte Bearbeitung Nehmen Sie Änderungen innerhalb einer ausgewählten Zuordnungsverzweigung vor, ohne den entsprechenden Inhalt in anderen Verzweigungen zu beeinflussen.
- Paralleles Authoring Ermöglichen Sie es mehreren Teams, gleichzeitig an verschiedenen Versionen, Funktionen oder Fehlerbehebungen in ihren jeweiligen Zuordnungszweigen zu arbeiten.
- Unabhängige Veröffentlichung Veröffentlichen Sie die Dokumentation aus einzelnen Kartenzweigen, ohne auf den Abschluss von Änderungen in anderen Zweigen zu warten.
- Kontrolliertes Zusammenführen Zusammenführen von Änderungen von einer Zuordnungsverzweigung in die Standardverzweigung (
main) mit der Möglichkeit, Konflikte zu überprüfen und zu lösen.
Verzweigung vs. Baselines
Eine Baseline identifiziert eine bestimmte Kombination von Themenversionen für eine DITA-Zuordnung, sodass Sie mithilfe dieser ausgewählten Versionen eine Ausgabe generieren können.
Eine Verzweigung bietet eine separate Bearbeitungsumgebung für eine DITA-Zuordnung und deren Inhalt, sodass Autoren Änderungen vornehmen können, ohne andere Verzweigungen derselben Zuordnung zu beeinflussen.
Künftige Funktionen
Die folgenden Funktionen werden derzeit nur im Standardzweig (main) unterstützt und sollen in zukünftigen Versionen von Experience Manager Guides auch in anderen Zweigen einer DITA-Zuordnung unterstützt werden:
- Suchen
- Suchen und Ersetzen
- Überprüfen von Workflows