Projects [SHOW]

Schritt 1. Anlegen eines Repository

Ein Repository wird in der Regel zur Organisation eines einzelnen Projekts verwendet. Repositorys können Ordner und Dateien, Bilder, Videos, Tabellenkalkulationen und Datensätze enthalten - alles, was Ihr Projekt benötigt. Wir empfehlen, ein README oder eine Datei mit Informationen über Ihr Projekt beizufügen. GitHub macht es einfach, eine solche Datei hinzuzufügen, während Sie Ihr neues Repository erstellen. Es bietet auch andere gängige Optionen wie eine Lizenzdatei.

Ihr hello-world Repository kann ein Ort sein, an dem Sie Ideen und Ressourcen speichern oder sogar Dinge mit anderen teilen und diskutieren können.

So erstellen Sie ein neues Repository

1. Klicken Sie in der oberen rechten Ecke neben Ihrem Avatar oder Identicon und wählen Sie dann Neues Repository.
2. Benennen Sie Ihr Projektarchiv hello-world.
3. Schreibe eine kurze Beschreibung.
4. Wählen Sie "Select Initialize this repository with a README".

Schritt 2. Erstellen Sie einen Zweig (Branch)

Verzweigen (branching) ist die Art und Weise, wie man an verschiedenen Versionen eines Repositorys gleichzeitig arbeiten kann.

Standardmäßig hat Ihr Repository einen Zweig mit dem Namen master, der als endgültiger Zweig betrachtet wird. Wir verwenden Zweige, um zu experimentieren und Änderungen vorzunehmen, bevor wir sie an den Master übertragen.

Wenn Sie einen Zweig außerhalb des Hauptzweigs erstellen, machen Sie eine Kopie oder einen Schnappschuss des Master, wie er zu diesem Zeitpunkt war. Wenn jemand anderes Änderungen am Hauptzweig vorgenommen hat, während Sie an Ihrem Zweig gearbeitet haben, können Sie diese Aktualisierungen einspielen.

Dieses Diagramm zeigt:

• Der Master-Zweig
• Ein neuer Zweig namens "Feature" (weil wir an diesem Zweig 'Feature-Arbeiten' durchführen)
• Die Reise, die das Feature vor der Verschmelzung mit dem Meister macht

Haben Sie jemals verschiedene Versionen einer Datei gespeichert? Etwas wie:

• story.txt
• story-joe-edit.txt
• story-joe-edit-reviewed.txt

Zweige erreichen ähnliche Ziele in GitHub-Repositories.

Hier bei GitHub verwenden unsere Entwickler, Autoren und Designer Zweige, um Fehlerbehebungen und Feature-Arbeiten von unserem Master-(Produktions-)Zweig getrennt zu halten. Wenn eine Änderung fertig ist, führen sie ihren Zweig in den Master-Zweig ein.

jetzt haben Sie zwei Zweige, Master und Readme-Edits. Sie sehen genau gleich aus, aber nicht mehr lange! Als nächstes fügen wir unsere Änderungen in den neuen Zweig ein.

Schritt 3. Änderungen vornehmen und übertragen

Bravo! Jetzt sind Sie in der Code-Ansicht für Ihren Readme-Edits-Zweig, der eine Kopie des Masters ist. Lass uns ein paar Änderungen vornehmen.

Auf GitHub werden gespeicherte Änderungen Commits genannt. Jeder Commit hat eine zugehörige Commit-Nachricht, die eine Beschreibung ist, die erklärt, warum eine bestimmte Änderung vorgenommen wurde. Commit-Nachrichten erfassen den Verlauf Ihrer Änderungen, so dass andere Mitwirkende verstehen können, was Sie getan haben und warum.

Make and commit changes

• Klicken Sie die Datei README.md an.
• Klicken Sie zum Bearbeiten auf das Bleistiftsymbol in der oberen rechten Ecke der Dateiansicht.
• Schreiben Sie im Editor ein wenig über sich selbst.
• Schreiben Sie eine Commit-Nachricht, die Ihre Änderungen beschreibt.
• Klicken Sie auf die Schaltfläche Änderungen übertragen.

Diese Änderungen werden nur an der README-Datei in Ihrem Readme-Edits-Zweig vorgenommen, so dass dieser Zweig nun Inhalte enthält, die sich vom Master unterscheiden.

Schritt 4. Öffnen Sie eine Pull-Anfrage

Gut gemacht! Nun, da Sie Änderungen in einem Zweig des Masters haben, können Sie einen Pull-Request öffnen.

Pull-Requests sind das Herzstück der Zusammenarbeit auf GitHub. Wenn Sie eine Pull-Anforderung öffnen, schlagen Sie Ihre Änderungen vor und bitten jemanden, Ihren Beitrag zu überprüfen und einzuziehen und in seinem Zweig zusammenzuführen. Pull-Requests zeigen Unterschiede oder Abweichungen des Inhalts aus beiden Zweigen an. Die Änderungen, Ergänzungen und Abzüge werden in grün und rot angezeigt.

Sobald Sie einen Commit machen, können Sie eine Pull-Anfrage öffnen und eine Diskussion starten, noch bevor der Code fertig ist.

Durch die Verwendung des @mention-Systems von GitHub in Ihrer Pull-Anforderungsnachricht können Sie nach Feedback von bestimmten Personen oder Teams fragen, egal ob sie sich am Ende des Flurs oder 10 Zeitzonen entfernt befinden.

Sie können sogar Pull-Requests in Ihrem eigenen Repository öffnen und sie selbst zusammenführen. Es ist eine großartige Möglichkeit, den GitHub-Fluss zu lernen, bevor Sie an größeren Projekten arbeiten.

Öffnen Sie einen Pull-Request für Änderungen an der README
Klicken Sie auf das Bild für eine größere Version

Klicken Sie auf die Registerkarte "Abrufanforderung" und dann auf der Seite "Abrufanforderung" auf die grüne Schaltfläche "Neue Abrufanforderung".
Wählen Sie im Feld Beispielvergleiche den von Ihnen erstellten Zweig, readme-edits, zum Vergleich mit dem Master (dem Original) aus.
Schauen Sie sich Ihre Änderungen in den Diffs auf der Vergleichsseite an, stellen Sie sicher, dass sie das sind, was Sie einreichen wollen.
Wenn Sie sich davon überzeugt haben, dass dies die Änderungen sind, die Sie einreichen möchten, klicken Sie auf die große grüne Schaltfläche Create Pull Request.
Geben Sie Ihrem Pull-Request einen Titel und schreiben Sie eine kurze Beschreibung Ihrer Änderungen.

Wenn Sie mit Ihrer Nachricht fertig sind, klicken Sie auf Create pull request!

Schritt 5. Zusammenführen Ihrer Pull-Anfrage

In diesem letzten Schritt ist es an der Zeit, Ihre Änderungen zusammenzuführen - den Readme-Edits-Zweig mit dem Master-Zweig zusammenzuführen.

Klicken Sie auf die grüne "Merge pull request"-Schaltfläche, um die Änderungen im Master-Zweig zusammenzuführen.
Klicken Sie auf "Confirm merge".
Fahren Sie fort und löschen Sie den Zweig, da seine Änderungen übernommen wurden, mit der Schaltfläche "Delete branch" im violetten Kasten.

Celebrate!

Durch das Absolvieren dieses Tutorials haben Sie gelernt, ein Projekt zu erstellen und eine Pull-Anfrage auf GitHub zu stellen!

Hier ist, was Sie in diesem Tutorial erreicht haben:

• Ein Open-Source-Repository erstellt
• Gründung und Leitung einer neuen Niederlassung
• Hat eine Datei geändert und diese Änderungen an GitHub übergeben
• Öffnen und Zusammenführen eines Pull-Requests

Werfen Sie einen Blick auf Ihr GitHub-Profil und Sie werden Ihre neuen Beitragsquadrate sehen! (contribution squares)

Um mehr über die Kraft von Pull Requests zu erfahren, empfehlen wir Ihnen, den GitHub-Flow Guide zu lesen. Sie können auch GitHub Explore besuchen und sich an einem Open-Source-Projekt beteiligen.