Doe mee met de Social Coding Trend en draag bij aan GitHub Repositories

Heb je ooit een pakket op GitHub gevonden dat je leuk vond, maar wilde je een snelle functie toevoegen, een gevonden bug repareren of misschien gewoon bijdragen aan open source als geheel? Sluit u aan bij de trend van sociale codering, deel uw vaardigheden en help mee met de open source-wereld. In dit artikel leer je alles over hoe je code bijdraagt ​​aan een repository op GitHub of een gehoste git-service.

Installeer de installatie

In dit artikel wordt ervan uitgegaan dat je al een GitHub-account hebt, maar zo niet, ga dan snel registreer voor een gratis account. Zorg er ook voor dat u al een git geïnstalleerd door het volgende commando in terminal uit te voeren:

git --version

Als u in plaats van het versienummer te zien de melding "commando niet gevonden" krijgt, mag u installeren git met het commando:

sudo apt-get -y install git

Fork de repository

Eerst moet u de repository kiezen waaraan u wilt bijdragen, en deze bezoeken in uw webbrowser. Als u niet zeker weet welke repository u moet kiezen, kunt u de demo-repository gebruiken op

https://github.com/mdizak/muo_demo. Dit is een eenvoudige demo en u kunt er pull-verzoeken tegen maken voor test- en leerdoeleinden.

Zoek tijdens het bekijken van de repository in uw webbrowser naar het Fork-opslagplaats knop, en klik erop. Dit zal de repository naar je eigen GitHub-account splitsen en je ernaartoe brengen. Vervolgens moet je kloon de nieuw gevorkte repository, dus open terminal op uw lokale computer en voer het volgende uit:

Hoe een repository te klonen met GitHub Desktop

Wil je de software op GitHub leren kennen? Hier leest u hoe u het naar het oosten kunt maken met de gestroomlijnde GitHub Desktop-tool.

git kloon https://github.com/myusername/muo_demo.git
cd muo_demo

Zorg er natuurlijk voor dat u de bovenstaande URL wijzigt in die van uw nieuwe gevorkte repository. Eenmaal gekloond, voegt u de originele repository toe als een upstream met de opdracht:

git remote add stroomopwaarts https://github.com/mdizak/muo_demo.git

Zorg ervoor dat u de URL in de bovenstaande opdracht wijzigt met die van de originele repository die u hebt gekloond. Dit betekent voor git dat het een bovenliggende repository is van waaruit je werkt.

Bereid een lokale repository voor

Voordat u aan een nieuwe bijdrage begint te werken, moet u ervoor zorgen dat u de nieuwste codebasis van de bovenliggende repository gebruikt. Voer in de projectdirectory de volgende opdrachten uit in terminal:

git checkout master
git pull upstream master && git push oorsprong master

Het eerste commando zorgt ervoor dat je momenteel in de master branch werkt, en het tweede commando synchroniseert de bovenliggende repository met zowel je lokale als GitHub repositories. Dit zorgt ervoor dat u de meest recente codebasis aanpast en niet met verouderde code werkt.

Zorg er ook voor dat u controleert of het project een contribut.md-bestand heeft, en zo ja, volg dan wat het zegt. Soms hebben projecten specifieke richtlijnen met betrekking tot het leveren van bijdragen, die altijd moeten worden opgevolgd.

Maak een nieuwe vestiging aan

Je moet een nieuwe branch maken die alle wijzigingen voor deze bijdrage zal bevatten, die later door de projectbeheerders zal worden samengevoegd in de hoofdrepository van GitHub. De vertakking moet alfanumeriek zijn en kan elke gewenste naam hebben.

Hoewel het niet verplicht is, wordt het algemeen beschouwd als een normale beleefdheid om de filiaalnaam voor te voegen hotfix / voor snelle bugfixes of voorzien zijn van/ voor extra functies. Kies de gewenste filiaalnaam en voer het commando uit:

git checkout -b feature / my_cool_feature

U dient altijd een aparte branch aan te maken voor elke feature / bugfix, en nooit meerdere bijdragen in één op te nemen. Dit helpt om een ​​soepele ontwikkelingsstroom te behouden en zorgt er ook voor dat uw bijdrage wordt geaccepteerd en opgenomen in het project.

Nu je branch is aangemaakt, ga je gang en voltooi alle noodzakelijke aanpassingen die je wilt met de standaard git-werkstroom.

Commit en maak Pull Request

Zodra u klaar bent met uw bijdrage, legt u deze vast met een juiste commit bericht en push het naar je gevorkte repository met de commando's:

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

De laatste stap is het maken van een pull-verzoek om de projectbeheerders te waarschuwen dat er een nieuwe bijdrage in afwachting is. Bezoek de gevorkte GitHub-repository in je webbrowser en je ziet een vervolgkeuzeknop waarmee je takken kunt wijzigen. Verander naar je nieuw aangemaakte branch, en de volgende pagina zal een link bevatten waarmee je een nieuw pull request kunt aanmaken.

Als je op die link klikt, zie je een pagina met je vastleggingsbericht en alle wijzigingen die je in de code hebt aangebracht. Bekijk alles om er zeker van te zijn dat het correct is, voeg eventueel een extra bericht voor de beheerders toe en dien het pull-verzoek in.

Blijf bijdragen aan GitHub

Gefeliciteerd, je hebt met succes een bijdrage ingediend voor een GitHub-project!

Uw pull-verzoek wacht nu op beoordeling en goedkeuring door de projectbeheerders, en u wordt per e-mail op de hoogte gebracht of het al dan niet is goedgekeurd, en met eventuele berichten die ze voor u hebben. Nu je hebt geleerd hoe je kunt bijdragen aan projecten op GitHub, blijf vooruitgaan en help het open source gemeenschap.

Hoe u meer RAM aan uw Android-apparaat kunt toevoegen met een MicroSD-kaart

Als je Android-telefoon of -tablet een beetje traag werkt, heeft deze misschien wat meer RAM nodig. Daar kunnen wij bij helpen.

Over de auteur