Treten Sie dem Social Coding-Trend bei und tragen Sie zu GitHub-Repositories bei

Haben Sie jemals ein Paket auf GitHub gefunden, das Ihnen gefallen hat, wollten aber eine schnelle Funktion hinzufügen, einen gefundenen Fehler beheben oder einfach nur zu Open Source als Ganzes beitragen? Schließen Sie sich dem Trend des Social Coding an, teilen Sie Ihre Fähigkeiten und helfen Sie der Open Source-Welt. In diesem Artikel erfahren Sie alles darüber, wie Sie Code zu einem Repository auf GitHub oder einem gehosteten Git-Dienst beitragen können.

Setup einrichten

In diesem Artikel wird davon ausgegangen, dass Sie bereits einen GitHub-Account haben. Wenn nicht, bitte schnell Registrieren Sie sich für ein kostenloses Konto. Stellen Sie außerdem sicher, dass Sie bereits haben git Installiert durch Ausführen des folgenden Befehls im Terminal:

Git - Version

Wenn anstelle der Versionsnummer die Meldung "Befehl nicht gefunden" angezeigt wird, können Sie die Installation durchführen git mit dem Befehl:

sudo apt-get -y git installieren

Fork das Repository

Zuerst müssen Sie das Repository auswählen, zu dem Sie beitragen möchten, und es in Ihrem Webbrowser aufrufen. Wenn Sie sich nicht sicher sind, welches Repository Sie auswählen sollen, können Sie das Demo-Repository unter verwenden

https://github.com/mdizak/muo_demo. Dies ist eine einfache Demo, und Sie können gerne Pull-Anforderungen für Test- und Lernzwecke erstellen.

Achten Sie beim Anzeigen des Repositorys in Ihrem Webbrowser auf die Fork Repository Schaltfläche und klicken Sie darauf. Dadurch wird das Repository in Ihr eigenes GitHub-Konto aufgeteilt und Sie gelangen dorthin. Als nächstes müssen Sie Klonen Sie das neu gegabelte RepositoryÖffnen Sie also das Terminal auf Ihrem lokalen Computer und führen Sie Folgendes aus:

So klonen Sie ein Repository mit GitHub Desktop

Möchten Sie die Software auf GitHub in den Griff bekommen? Hier erfahren Sie, wie Sie mit dem optimierten GitHub Desktop-Tool nach Osten gelangen.

Git-Klon https://github.com/myusername/muo_demo.git
cd muo_demo

Stellen Sie natürlich sicher, dass Sie die obige URL in die Ihres neu gegabelten Repositorys ändern. Fügen Sie nach dem Klonen das ursprüngliche Repository als Upstream mit dem folgenden Befehl hinzu:

Git Remote Add Upstream https://github.com/mdizak/muo_demo.git

Stellen Sie sicher, dass Sie die URL im obigen Befehl mit der des ursprünglichen Repositorys ändern, das Sie geklont haben. Dies bedeutet, dass es sich um ein übergeordnetes Repository handelt, an dem Sie arbeiten.

Bereiten Sie das lokale Repository vor

Stellen Sie jedes Mal, bevor Sie mit der Arbeit an einem neuen Beitrag beginnen, sicher, dass Sie die neueste Codebasis des übergeordneten Repositorys ausführen. Führen Sie im Projektverzeichnis die folgenden Befehle im Terminal aus:

Git Checkout Master
Git Pull Upstream Master & Git Push Origin Master

Der erste Befehl stellt sicher, dass Sie derzeit im Hauptzweig arbeiten, und der zweite Befehl synchronisiert das übergeordnete Repository sowohl mit Ihrem lokalen als auch mit Ihrem GitHub-Repository. Dadurch wird sichergestellt, dass Sie die aktuellste Codebasis ändern und nicht mit veraltetem Code arbeiten.

Stellen Sie außerdem sicher, dass das Projekt über eine Datei "contrib.md" verfügt. Wenn dies der Fall ist, befolgen Sie bitte die Anweisungen. Manchmal haben Projekte spezifische Richtlinien für die Bereitstellung von Beiträgen, die immer befolgt werden sollten.

Erstellen Sie einen neuen Zweig

Sie müssen einen neuen Zweig erstellen, der alle Änderungen für diesen Beitrag enthält, der später von den Projektbetreuern in das Haupt-GitHub-Repository eingefügt wird. Der Zweig muss alphanumerisch sein und kann beliebig benannt werden.

Obwohl dies nicht erforderlich ist, wird es im Allgemeinen als gängige Höflichkeit angesehen, dem Filialnamen ein Präfix voranzustellen hotfix / für schnelle Fehlerbehebungen oder Merkmal/ für zusätzliche Funktionen. Wählen Sie den gewünschten Filialnamen und führen Sie den folgenden Befehl aus:

git checkout -b feature / my_cool_feature

Sie sollten immer einen separaten Zweig für jede Funktion / Fehlerbehebung erstellen und niemals mehrere Beiträge in einem enthalten. Dies trägt dazu bei, einen reibungslosen Entwicklungsfluss aufrechtzuerhalten und sicherzustellen, dass Ihr Beitrag akzeptiert und in das Projekt einbezogen wird.

Nachdem Ihr Zweig erstellt wurde, führen Sie alle erforderlichen Änderungen mit dem Standard-Git-Workflow durch.

Pull-Anforderung festschreiben und erstellen

Wenn Sie die Arbeit an Ihrem Beitrag abgeschlossen haben, legen Sie ihn mit a fest richtige Commit-Nachricht und schieben Sie es mit den folgenden Befehlen in Ihr gegabeltes Repository:

git commit --file commit.txt
git push -u origin feature / my_cool_feature

Der letzte Schritt besteht darin, eine Pull-Anforderung zu erstellen, die die Projektbetreuer darauf hinweist, dass ein neuer Beitrag aussteht. Besuchen Sie das gegabelte GitHub-Repository in Ihrem Webbrowser, und Sie sehen eine Dropdown-Schaltfläche, mit der Sie Zweige wechseln können. Wechseln Sie zu Ihrem neu erstellten Zweig, und die nächste Seite enthält einen Link, über den Sie eine neue Pull-Anforderung erstellen können.

Wenn Sie auf diesen Link klicken, wird eine Seite mit Ihrer Commit-Nachricht und allen Änderungen angezeigt, die Sie im Code vorgenommen haben. Überprüfen Sie alles, um sicherzustellen, dass es korrekt ist, fügen Sie alle erforderlichen zusätzlichen Nachrichten für die Betreuer hinzu und senden Sie die Pull-Anforderung.

Weiter zu GitHub beitragen

Herzlichen Glückwunsch, Sie haben erfolgreich einen Beitrag zu einem GitHub-Projekt eingereicht!

Ihre Pull-Anfrage wartet nun auf die Überprüfung und Genehmigung durch die Projektbetreuer. Sie werden per E-Mail darüber informiert, ob sie genehmigt wurde oder nicht, und über alle Nachrichten, die sie für Sie haben. Nachdem Sie nun gelernt haben, wie Sie zu Projekten auf GitHub beitragen können, können Sie sich weiterentwickeln und dabei helfen, das Projekt zu erweitern Open Source Community.

So fügen Sie Ihrem Android-Gerät mit einer MicroSD-Karte mehr RAM hinzu

Wenn Ihr Android-Telefon oder -Tablet etwas langsam läuft, benötigt es möglicherweise etwas mehr RAM. Wir können dabei helfen.

Über den Autor