Gå med i den sociala kodningstrenden och bidra till GitHub Repositories

Har du någonsin hittat ett paket på GitHub som du tyckte om, men ville lägga till en snabbfunktion, fixa ett fel du hittade eller kanske bara bidra till öppen källkod som helhet? Gå med i trenden med social kodning, dela med dig av dina kunskaper och hjälp till öppen källkodsvärld. I den här artikeln lär du dig allt om hur du kan bidra med kod till ett arkiv på GitHub eller någon annan git-tjänst.

Skaffa installation

Den här artikeln förutsätter att du redan har ett GitHub-konto, men om inte snälla snabbt registrera dig för ett gratis konto. Se också till att du redan har git installeras genom att köra följande kommando i terminalen:

git --version

Om du får ett "kommando hittades" -meddelande istället för att se versionsnumret kan du installera git med kommandot:

sudo apt-get -y installera git

Gaffla förvaret

Först måste du välja förvaret du vill bidra till och besöka det i din webbläsare. Om du är osäker på vilket förråd du ska välja kan du använda demoförvaret på https://github.com/mdizak/muo_demo

. Detta är en enkel demo, och du är välkommen att skapa pull-förfrågningar mot den för test- och inlärningsändamål.

När du tittar på förvaret i din webbläsare letar du efter Gaffelförvar och klicka på den. Detta kommer att förvara förvaret till ditt eget GitHub-konto och ta dig till det. Nästa du behöver klona det nyligen gafflade förvaret, så öppna terminalen på din lokala dator och kör:

Hur man klonar ett arkiv med GitHub Desktop

Vill du ta hand om programvara på GitHub? Så här gör du det österut med det strömlinjeformade GitHub Desktop-verktyget.

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

Se till att du naturligtvis ändrar webbadressen ovan till den i ditt nyfördelade förvar. När du har klonat, lägg till originalförvaret som ett uppströms med kommandot:

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

Se till att ändra webbadressen i kommandot ovan med det för det ursprungliga förvaret du klonade. Detta betyder att git är att det är ett överordnat arkiv som du arbetar med.

Förbered lokalt arkiv

Varje gång innan du börjar arbeta med ett nytt bidrag, se till att du kör den senaste kodbasen i det överordnade arkivet. Kör följande kommandon i terminalen i projektkatalogen:

git checkout master
git pull upstream master && git push origin master

Det första kommandot säkerställer att du för närvarande arbetar i huvudgrenen, och det andra kommandot synkroniserar det överordnade arkivet med både dina lokala och GitHub-arkiv. Detta säkerställer att du ändrar den mest uppdaterade kodbasen och inte arbetar med föråldrad kod.

Se också till att kontrollera om projektet har enribute.md-fil, och i så fall se till att följa vad det står. Ibland har projekt specifika riktlinjer för hur man kan ge bidrag, som alltid bör följas.

Skapa en ny filial

Du måste skapa en ny gren som kommer att innehålla alla modifieringar för detta bidrag, som senare kommer att slås ihop i huvud GitHub-förvaret av projektansvariga. Filialen måste vara alfanumerisk och kan namnges allt du vill.

Även om det inte krävs anses det allmänt vara artigt att prefixa filialnamnet med snabbkorrigering / för snabba felkorrigeringar eller funktion/ för extra funktioner. Välj önskat filialnamn och kör kommandot:

git checkout -b-funktion / my_cool_feature

Du bör alltid skapa en separat gren för varje funktion / bug fix och aldrig inkludera flera bidrag i en. Detta hjälper till att upprätthålla ett smidigt utvecklingsflöde och hjälper också till att säkerställa att ditt bidrag accepteras och ingår i projektet.

Nu när din filial har skapats, fortsätt och slutför alla nödvändiga modifieringar du vill med standard git-arbetsflödet.

Begå och skapa pull-begäran

När du har slutfört arbetet med ditt bidrag, gör det med en rätt begå meddelande och tryck det till ditt gaffelförvar med kommandona:

git commit --file commit.txt
git push -u ursprung / my_cool_feature

Det sista steget är att skapa en pull-begäran som varnar projektansvariga om att ett nytt bidrag väntar. Besök det gafflade GitHub-förvaret i din webbläsare så visas en rullgardinsmeny som låter dig byta gren. Byt till din nyskapade gren, och nästa sida innehåller en länk så att du kan skapa en ny pull-begäran.

När du klickar på den länken kommer du att se en sida som visar ditt meddelande och alla ändringar du har gjort inom koden. Granska allt för att säkerställa att det är korrekt, lägg till eventuella ytterligare meddelanden till underhållarna och skicka pull-begäran.

Fortsätt att bidra till GitHub

Grattis, du har skickat in ett bidrag till ett GitHub-projekt!

Din pull-begäran väntar nu på granskning och godkännande av projektansvariga, och du kommer att meddelas via e-post om den har godkänts eller inte, och med alla meddelanden de har åt dig. Nu när du har lärt dig hur du kan bidra till projekt på GitHub, fortsätt framåt och hjälp att växa öppen källkod.

Så här lägger du till mer RAM till din Android-enhet med ett MicroSD-kort

Om din Android-telefon eller surfplatta går lite långsamt kan det bara behöva lite mer RAM. Vi kan hjälpa till med det.

Om författaren