Verzweigungen
Die Verzweigung dient dazu, mehrere Versionen von zusammenhängenden Inhalten zu erstellen. Diese Funktion ähnelt dem Kopieren, ist aber umfangreicher und bietet Ihnen mehr Möglichkeiten, mit Ihren Inhalten zu arbeiten. Mit einem Zweig erstellen Sie eine neue Version einer Publikation oder eines Topics, der sich wie eine Kopie verhält, von der Paligo jedoch weiß, dass er mit der Originalversion in Verbindung steht. Das bedeutet, dass das Original und der Zweig separat als parallele Versionen verwendet werden können oder später wieder zu einer einzigen Version zusammengeführt werden können. Wählen Sie einen der beiden Verzweigungsmodi von Paligo, siehe Verzweigungsmodus auswählen.
[en] With a branch, you create a new version of a publication or topic. This new version acts like a copy, but Paligo understands it is related to the original version. So depending on your requirements, you can:
-
[en] Use the original version and the branched version separately as parallel versions
-
[en] Merge the original and the branched version back into a single version at a later time.
In der folgenden Abbildung wurde beispielsweise das Benutzerhandbuch „Acme HomeHub“ verzweigt. Das Original (1) und die verzweigte Version (2) existieren beide als separate Publikationen mit getrennten Topics. Sie können sie weiterhin als separate Versionen verwenden oder sie zu einer Publikation zusammenführen.
 |
1 = Original, 2 = Verzweigte Version
[en] This is just one way of using branching. You could have branched publications with reused topics or a mix of reused and unique topics too. There are many different possibilities.
Tipp
[en] Use branching with care. It is a powerful feature that can help you save time by creating and merging different versions of content. But without careful planning, it can also make your content over-complicated and more difficult to manage. We recommend that you avoid over-complicated branch structures.
[en] Common Use Cases for Branching
Die häufigsten Anwendungsfälle für die Arbeit mit Zweigen:
-
Bearbeitung während eines Versions-Updates – Sie arbeiten an einer Version für ein bestimmtes Produkt, das sich noch in der Entwicklung befindet und gerade aktualisiert wird. Dann steht die nächste Aktualisierung des Produkts an und Sie müssen mit der Arbeit an der Dokumentation für diese Version beginnen, siehe ???.
[en] You use one branch for publishing the official documentation for the latest product release. You use the other branch to work on updates for the next product release.
-
Zwei verschiedene Versionen, die parallel verwendet werden und für die Änderungen erforderlich sind, die leicht in beide Versionen übernommen werden können.
[en] You need to update and publish two similar, but different, publications. For example, if you have user guides for two different models of a product that only have minor variations.
-
Mit dem Inhalt experimentieren – Sie erwägen einige größere Änderungen an der Dokumentation und der Struktur und Sie möchten experimentieren, bevor Sie die alte Version aufgeben. Führen Sie einen Zweig mit einem anderen Zweig zusammen, siehe Zweige zusammenführen.
[en] You are considering some major changes to the documentation and its structure. So you create a branch and use the original version for publishing and then experiment with a new structure in the branched version. If the experiment goes well, you can merge the branches later.
-
Arbeiten an größeren Änderungen, die einige Zeit in Anspruch nehmen werden – Sie arbeiten an einer größeren Änderung für die Dokumentation, die einige Zeit in Anspruch nehmen wird, aber das Entwicklungsteam nimmt viele kleine kontinuierliche Aktualisierungen vor, die Aktualisierungen in der Live-Dokumentation erfordern. Sie müssen also in der Lage sein, zwischenzeitlich zu veröffentlichen, bis die umfassende Überarbeitung der Dokumentation abgeschlossen ist.
[en] You need to make changes that will take a considerable amount of time to complete, but also need to publish minor updates on a regular basis. You can create a branch for your long-term changes and then either use the original branch or another branch for the quick updates.
-
Arbeiten während eines Übersetzungsprojekts – Verzweigungen sind notwendig, damit Sie an weiteren Entwicklungen arbeiten können, während die Inhalte übersetzt werden. Lesen Sie hierzu auch Inhalt aktualisieren, wenn Übersetzung nicht abgeschlossen ist.
[en] You need to send content for translation, but also work on the next version of the content while you are waiting for the translation to be returned. For this, you need to use branching.
Anmerkung
[en] Branching is a powerful tool that can save you a lot of time and make it easier to manage multiple versions of your content. But it can also become complex to manage, so we recommend that you only use it if you need it and you should also try to keep your branching as simple as possible. The more complex your branching, the more difficult it will be for people to understand how the content is branched and which branches they should work on.
[en] Getting Started with Branching
[en] To branch your content in Paligo, we recommend that you:
-
[en] Make sure you understand the basics of branching and merging.
[en] We explain how branching works in Paligo in these introductory sections:
-
[en] Set the branching mode for your Paligo instance. We recommend that you enable Consecutive branching mode as it allows for branching from other branches, which gives you more possibilities with branching. But if you have a specific need to only branch from the original branch, you can set Paligo to use Simplified branching mode instead.
[en] For instructions, see Verzweigungsmodus auswählen.
-
[en] Decide on what parts of your content need to be branched and choose the appropriate method of branching.
[en] Paligo has several different methods for branching and they each work differently as they are designed for different scenarios. To find out which method is going to work best for your requirements, see [en] Choose the Appropriate Branching Method.
-
[en] Create your branches!
[en] For instructions, see:
-
[en] If you need to merge a branch back into an earlier branch or the original branch, see Einen Topic-Zweig zusammenführen or Einen Publikationszweig zusammenführen.