Arbeiten mit Git und AsciiDoc

Lokal: Lokale Änderungen im feature-XYZ-Branch aufnehmen und veröffentlichen:

$ git branch
* main
$ git switch -c feature-XYZ
$ git branch
* feature-XYZ
  main
$ git push -u origin feature-XYZ
$   vi feature-XYZ.txt → git add . → git commit -m "..."
$   vi feature-XYZ.txt → git add . → git commit -m "..."
$ git push

GitHub: Pull-Request anlegen:

Code-Review durchführen:

GitHub: Sich über neue Kommentare im Pull-Request informieren.

Lokal: Gewünschte Nachbesserungen lokal im feature-XYZ-Branch durchführen und veröffentlichen. Der Pull-Request wird automatisch aktualisiert:

$ git switch feature-XYZ
$   vi feature-XYZ.txt → git add . → git commit -m "..."
$ git push

Code-Review durchführen und in GitHub Merge erlauben:

Der nicht mehr benötigte feature-XYZ-Branch kann jetzt auf GitHub und Lokal gelöscht werden.:

Erstellen Sie auf GitHub von einem öffentlichen Repository über den entsprechenden Button Fork einen Fork.

Abbildung 3. Fork-Button auf GitHub

Clonen Sie das in Ihrem Account als Kopie entstandene Repository auf Ihren lokalen Rechner.

(optional) Erstellen Sie lokal einen neuen Branch, bspw. patch-fix-XYZ, wechseln in diesen.

Nehmen die gewünschte Änderung bzw. Korrektur vor.

Nehmen Sie Ihre Änderungen als neue Version auf und pushen diese (samt zugehörigem patch-fix-XYZ-Branch) in Ihr remote-Repository auf GitHub.

Erstellen Sie einen Pull-Request für Ihre Änderung:

Kleinere Änderungen, wie bspw. Schreibfehler, können in der Quelldatei direkt auf GitHub über die Editieren-Funktion bearbeitet werden.

Abbildung 7. Editieren direkt in GitHub

GitHub stellt fest, dass Sie keine Schreibrechte für das Repository haben und legt für Sie einen Fork mit zugehörigem Patch-Branch und Pull-Request an.

You’re making changes in a project you don’t have write access to. We’ve created a fork of this project for you to commit your proposed changes to. Submitting a change will write it to a new branch in your fork, so you can send a pull request.

Nach dem Editieren der Datei und der Vergabe einer kurzen Beschreibung, kann mit dem Button Propose Changes die Änderung als Pull-Request vorgeschlagen werden.

Abbildung 8. Änderungen Vorschlagen nach Bearbeitung direkt auf GitHub

nach abgeschlossenem Pull-Request löschen

für neue Änderungsvorschläge das Quellrepository erneut forken

Falls noch nicht vorhanden den Fork lokal clonen:

$ git clone ...

Den durch GitHub erstellten Pull-Request tigion-main-Branch lokal bereitstellen:

$ git checkout -b tigion-main main
$ git pull https://github.com/tigion/htw-playground-fork-colors.git main

In den eigenen main-Branch wechseln und den tigion-main-Branch hinein mergen:

$ git switch main
$ git merge --no-ff tigion-main

Die auftretenden merge-Konflikte lösen.

Den main-Branch zu GitHub pushen:

$ git push origin main

Mit Fetch upstream gefolgt von einem Compare

switching the base | compare across forks and switch manually

Create pull request

wechsle Merge pull request → Rebase und merge

Confirm rebase and merge

add remote as "upstream":

fetch branches of remote into remote-tracking branches:

switch to your main-branch:

Rewrite your main branch:

Als erstes sucht man sich auf GitHub über den Reiter Pull Requests die ID des betreffenden Pull-Requests heraus. Lautet die ID #11 ist die Nummer 11 relevant, welche ich folgend beispielhaft verwende.

Jetzt erzeugen wir auf Grundlage der Referenz zur Pull-Request ID-Nummer einen neuen Branch. Ich nenne den neuen Branch pr-11.

% git branch
* main
% git fetch origin pull/11/head:pr-11
% git branch
* main
  pr-11

Wir wechseln in den neuen pr-11-Branch und können den Inhalt des Pull-Requests jetzt lokal testen und untersuchen.

% git switch pr-11
% git branch
  main
* pr-11

Sind wir fertig, können wir den pr-11-Branch, der nur zum Testen des Pull-Requests diente, wieder löschen und anschließend den Pull-Request auf GitHub weiter bearbeiten.

% git switch main
% git branch -D pr-11