FirstContribution

First Contribution

Es ist schwer. Es ist immer schwer, wenn Sie das erste Mal etwas tun. Besonders wenn Sie zusammenarbeiten, ist es keine bequeme Sache, Fehler zu machen. Wir wollten die Art und Weise vereinfachen, wie neue Open-Source-Mitwirkende zum ersten Mal lernen und Beitrag leisten.

Das Lesen von Artikeln und das Ansehen von Tutorials kann helfen, aber was ist besser, als das Zeug in einer Übungsumgebung tatsächlich zu tun? Dieses Projekt zielt darauf ab, Leitlinien zu liefern und die Art und Weise zu vereinfachen, wie Anfänger ihren ersten Beitrag leisten. Wenn Sie Ihren ersten Beitrag leisten möchten, befolgen Sie die folgenden Schritte.

Wenn Sie kein Git auf Ihrem Computer haben, installieren Sie ihn.

Fork dieses Repository

Geben Sie dieses Repository auf, indem Sie oben auf dieser Seite auf die Schaltfläche Gabel klicken. Dadurch wird eine Kopie dieses Repositorys in Ihrem Konto erstellt.

Klonen Sie das Repository

Klonen Sie nun das Forked Repository in Ihre Maschine. Gehen Sie zu Ihrem GitHub -Konto, öffnen Sie das Forked Repository, klicken Sie auf die Schaltfläche Klon und klicken Sie dann auf das Symbol "CHIPLED SYMON" .

Öffnen Sie einen Terminal und führen Sie den folgenden Git -Befehl aus:

 git clone "url you just copied"

Wo "URL Sie gerade kopiert haben" (ohne die Zitatmarken) ist die URL zu diesem Repository (Ihre Gabel dieses Projekts). Siehe die vorherigen Schritte, um die URL zu erhalten.

Zum Beispiel:

 git clone https://github.com/this-is-you/FirstContribution.git

Wo this-is-you bist dein Github-Benutzername. Hier kopieren Sie den Inhalt des First Contribution Repository auf GitHub auf Ihren Computer.

Erstellen Sie einen Zweig

Wechseln Sie in das Repository -Verzeichnis auf Ihrem Computer (wenn Sie noch nicht da sind):

 cd FirstContribution

Erstellen Sie nun einen Zweig über den Befehl git checkout :

 git checkout -b <add-your-new-branch-name>

Zum Beispiel:

 git checkout -b add-alonzo-church

(Der Name des Zweigs muss nicht das Wort hinzufügen lassen, aber es ist eine vernünftige Sache, da der Zweck dieses Zweigs darin besteht, Ihren Namen einer Liste hinzuzufügen.)

Nehmen Sie die notwendigen Änderungen vor und begehen Sie diese Änderungen

Öffnen Sie nun die Datei Contributors.md in einem Texteditor, fügen Sie Ihren Namen hinzu. Speichern Sie nun die Datei.

Wenn Sie zum Projektverzeichnis gehen und den Befehls git status ausführen, werden Sie feststellen, dass Änderungen vorliegen.

Fügen Sie diese Änderungen in den Zweig hinzu, den Sie gerade mit dem Befehl git add erstellt haben:

 git add Contributors.md

Beachten Sie nun diese Änderungen mit dem Befehl git commit :

 git commit -m "Add <your-name> to Contributors list"

Ersetzen Sie <your-name> durch Ihren Namen.

Veränderungen in GitHub drücken

Drücken Sie Ihre Änderungen mit dem Befehl git push :

 git push origin <add-your-branch-name>

Ersetzen Sie <add-your-branch-name> durch den Namen der früheren Filiale, die Sie zuvor erstellt haben.

Senden Sie Ihre Änderungen zur Überprüfung ein

Wenn Sie in GitHub zu Ihrem Repository gehen, werden Sie eine Schaltfläche Compare & pull request angezeigt. Klicken Sie auf diese Schaltfläche.

Senden Sie nun die Pull -Anfrage ein.

Bald werde ich alle Ihre Änderungen in die Master -Zweigstelle dieses Projekts verschmelzen. Sie erhalten eine Benachrichtigungs -E -Mail, sobald die Änderungen zusammengeführt wurden.

Wohin gehen Sie von hier aus?

Glückwunsch! Sie haben gerade den Standardgabel abgeschlossen -> Klon -> Bearbeiten -> PR -Workflow, dem Sie häufig als Mitwirkender begegnen werden!

Sie können sich unserem Slack -Team anschließen, falls Sie Hilfe benötigen oder Fragen zu Slack -Team beitreten.