Mergen und Diskutieren: Beiträge zusammenführen
Auf dieser Seite ...
Mergen und Diskutieren: Beiträge zusammenführen#
Merge Requests: Beiträge diskutieren, annehmen und integrieren#
Eine Zusammenführungsanforderung (Merge Request) ist die Basis zum Diskutieren, Annehmen und Zusammenführen von Beiträgen. Es ist genau so, wie der Name schon sagt: eine Aufforderung, einen Zweig in einen anderen zusammenzuführen.
Hintergrund#
Ein Repository besteht aus seinem Standardzweig (Standard-Branch) namens master, der die Hauptversion des Inhalts enthält.
Aus diesem werden Verzweigungen, themenbezogene Feature-Branches, erstellt,
um Änderungen am Inhalt vorzuschlagen,
ohne diese direkt in die Hauptversion einzuführen.
Die Verzweigung ist besonders wichtig um zu vermeiden,
dass Änderungen ohne vorherige
Überprüfungen, Tests und Genehmigungen direkt in die Hauptversion übertragen werden.
Wenn Sie einen neuen Feature-Zweig erstellen und bearbeiten,
haben Sie die Möglichkeit, eine Merge Request zu erstellen.
Dies ist im Wesentlichen eine Anforderung,
einen Branch in einen anderen zusammenzuführen.
Der Zweig, in den Sie Ihre Änderungen eingefügt haben,
wird als Quellzweig bezeichnet,
während der Zweig,
in dem Sie Ihre Änderungen zusammenführen möchten,
als Zielzweig bezeichnet wird.
Der Zielzweig kann der Standard-Zweig master, oder auch ein beliebiger anderer Zweig
(z. B. der Zweig eines Abschnittredakteurs, der die Änderung zuerst begutachten soll)
sein, je nach gewünschtem Ergebnis.
Bei einem Merge Request können Sie nicht nur die Unterschiede zwischen dem ursprünglichen Inhalt und Ihren vorgeschlagenen Änderungen visualisieren, sondern auch eine erhebliche Anzahl von Aufgaben ausführen, bevor Sie Ihre Arbeit abschließen und die Zusammenführungsanforderung zusammengeführt wird. Ein Merge Request ist immer auch als Diskussionsgrundlage zu verstehen.
Wenn Sie eine neue Zusammenführungsanforderung starten, können Sie die folgenden Optionen sofort einschließen oder später hinzufügen, indem Sie auf der Seite der Zusammenführungsanforderung oben rechts auf die Schaltfläche Bearbeiten klicken:
An einen berechtigten Mitarbeiter zuweisen
Meilenstein definieren, um zeitkritische Änderungen zu verfolgen.
Aktivieren Sie die Option Quellzweig löschen, wenn Zusammenführungsanforderung akzeptiert wird, um Ihr Repository sauber zu halten. Löschen Sie Feature-Zweige beim Zusammenführen oder nach dem Zusammenführen, um Ihr Repository sauber zu halten.
Legen Sie die Zusammenführungsanforderung als WIP (Work In Progress) fest, um versehentliche Zusammenführungen zu vermeiden, bevor sie bereit sind.
Besprechen Sie Ihre Implementierung mit Ihrem Team in der Merge-Request-Diskussion
Erstellen eines Merge Requests: „Bitte übernimm‘ meinen Beitrag“#
Es gibt zwei wichtige Stellen an denen ein Merge Request gestartet werden kann:
In der WebIDE beim Speichern/Comitten eines Beitrags
In der Branch-Übersicht
Abb. 30 Starten eines Merge Request beim Committen in der WebIDE#
Mittels der Checkbox Start a new merge request kann gleichzeitig mit dem Commit auch eine Zusammenführungsanforderung (Merge Request) gestartet werden.
Abb. 31 Starten eines Merge Requests von der Branches-Übersicht#
Unter können alle Branches eines Repository angezeigt werden. Mittels des Buttons Merge-Request kann ein Merge Request gestartet werden.
Das Fenster „New Merge Request“#
Zusammenführungsanforderungen (auch als „MRs“ bezeichnet) enthalten zahlreiche Informationen zu den vorgeschlagenen Änderungen. Der Hauptteil eines MR enthält seine Beschreibung sowie sein Widget (das Informationen zu CI / CD-Pipelines anzeigt, sofern vorhanden), gefolgt von den Diskussionsthreads der Personen, die mit diesem MR zusammenarbeiten.
MRs enthalten auch Navigationsregisterkarten, auf denen Sie die Diskussion im Thread, die Liste der Commits, die Liste der Pipelines und Jobs, die Codeänderungen und Inline-Codeüberprüfungen sehen können.
Abb. 32 Ein neuer Merge Request#
Merge Requests enthalten zahlreiche Informationen zu den vorgeschlagenen Änderungen. Der Hauptteil eines MR enthält seine Beschreibung, gefolgt von den Diskussionen der Personen, die mit diesem MR zusammenarbeiten.
MRs enthalten auch Navigationsregisterkarten, auf denen Sie die Diskussion im Thread, die Liste der Commits und die Codeänderungen sehen können.
Von wo wohin? Eingabe des Ziel-Branches#
Die Zusammenführungsanforderung zielt standardmäßig auf den master-Zweig ab.
Sollte dies nicht gewünscht sein, z. B. weil man die Änderungen erst in einen anderen Branch (z. B. den Branch eines Kapitelredakteurs) integrieren möchte, muss dies in der Kopfzeile mittels Change branches entsprechend geändert werden.
Abb. 33 Quell- und Zielzweig (from … into …)#
Die Zusammenführungsanforderung zielt standardmäßig auf den master-Zweig ab.
Dies kann mittels Change branches geändert werden
Abb. 35 Änderung des Ziel-Zweigs#
… auf gabriel geändert.
Mit Compare branches and continue gelangt man wieder auf die Übersichtsseite.
Die Basisdaten#
Geben Sie auf der Seite „New Merge Request“* zunächst den Titel und die Beschreibung für die Zusammenführungsanforderung ein. Die Beschreibung soll möglichst klar die Änderungen und Besonderheiten zusammenfassen um den Reviewer entsprechend zu unterstützen.
Abb. 36 Merge Request: Titel und Beschreibung#
Die Beschreibung soll möglichst klar die Änderungen und Besonderheiten zusammenfassen um den Reviewer entsprechend zu unterstützen.
Review und Diskussion eines Merge Requests#
Ein Merge Request als Zusammenführungsanforderung ist immer als Diskussionsgrundlage zu verstehen. Dementsprechend sind die Möglichkeiten für Review und Diskussion von Merge Requests besonders wertvoll.
Diskussionen mittels Kommentarfunktion#
Abb. 40 Merge Request: Kommentarfunktion#
Auf der Seite des Merge Requests können Kommentare hinterlassen werden, somit kann hier eine Diskussion über die Änderungen geführt werden.
Abb. 41 Merge-Request-Seite mit Kommentar#
Anzeige und Review von Änderungen — Änderungsvergleiche#
Abb. 42 Merge Request#
Auf der Seite des Merge Requests können die darin enthaltenen Commits und die kumulativen Änderungen angezeigt werden.
Abb. 43 Anzeige der Änderungen, links alt, rechts neu.#
Hier wurden „nur“ Zeilenumbrüche in der Datei
Quelltext/Grundlagen/index.rst
eingefügt.
Abb. 44 Anzeige der Änderungen, links alt, rechts neu.#
Hier wurden „nur“ Zeilenumbrüche in der Datei
Quelltext/Grundlagen/index.rst
eingefügt.
Der Merge Request wird genehmigt …#
Wenn der Merge Request genehmigt wird
und der Feature-Branch in master integriert (gemerged) wird,
wird in der Regel der Feature-Branch wieder gelöscht.
Für weitere Änderungen soll ein neuer Feature- Branch erstellt werden.
Abb. 45 Der Merge Request wurde akzeptiert …#
Abb. 46 Diagramm der Abläufe in der Versionsverwaltung#
Mit Genehmigung des Merge Requests wurde die Änderung
(grüner Feature-Zweig, links)
in den master-Zweig (rot, rechts)
integriert, der Feature-Zweig Zeilenumbruch wurde bereits automatisch gelöscht.
Dieses Werk ist lizenziert unter der Creative Commons Namensnennung - Weitergabe unter gleichen Bedingungen 3.0 Österreich Lizenz (CC BY-SA 3.0 AT). Einzelne Beiträge und Medien können abweichend lizensiert sein.