Bidra via Github

Förutsättningar

För att kunna bidra via pull-förfrågningar finns det flera förutsättningar:

Vet hur man använder ett minimum av Git
Har ett Github-konto
Ha en del av projektet som du vill bidra till

Innan du går in på detaljerna kommer det att vara nödvändigt att göra en liten poäng om ordförrådet. Här är en liten ordlista med ord som vi ständigt använder med Git/Github:

repo: Förkortning av "Repository". Vi använder det här ordet för att beteckna en uppsättning filer versionerade med Git.
gren: Detta är en gren i ett Git-projekt. Filialer låter dig skapa en parallell version av koden någon gång i historien.
master: Anger repans huvudgren.
ursprung: Anger fjärrrepo. Hosted på Github, till exempel.
pull request: Detta är operationen som låter dig föreslå en kodändring till ett projekt på Github.
gaffel: Detta är ett repo som är en kopia av ett annat repo. Detta gör att du kan utgå från ett befintligt projekt för att modifiera det, förbättra det, korrigera det eller göra något annat med det.
uppströms: I fallet med en gaffel, betecknar den repo från vilken gaffeln kommer.
hämta: Detta är operationen som består i att hämta data från fjärrkontrollen lokalt.
push: Detta är operationen som tillåter att lokal data skickas till fjärrkontrollen.

Konfiguration

Gaffel

Det första du ska göra är att gå till Github för att skapa en gaffel av projektet som du vill bidra till.

För att till exempel bidra till Leek Wars-klienten, gå hit: Leek Wars Client

Sedan klickar du bara på "gaffeln"-knappen uppe till höger.

Genom att "fordra" projektet kommer Github att skapa en ny repo på ditt konto. Detta kommer att vara en kopia av originalprojektet.

Få sedan adressen till din github-repo, via url-adressen, eller genom att klicka på den gröna knappen "Klona eller ladda ner".

Gå till platsen där du vill placera din lokala repo och använd kommandot: git clone \ Glöm inte att ersätta "\".

Så. Du har skapat en gaffel av projektet och du har hämtat den lokalt, på din maskin. Men det finns en sak till att göra för att kunna fortsätta använda den utan bekymmer i framtiden.

Uppströms

Du måste sedan konfigurera uppströms, vilket gör att du kan uppdatera din repo från projekten.

Kommandot git remote -v låter dig lista de konfigurerade fjärradresserna.

ursprung https://github.com/DITT_ANVÄNDARNAMN/DITT_FORK.git (hämta) ursprung https://github.com/DITT_ANVÄNDARNAMN/DITT_FORK.git (push)

För närvarande bör du se två adresser konfigurerade som ursprung. En i hämtning, när du vill återföra nya funktioner från din fjärrkontroll, din repo värd på Github. Och den andra i push som omvänt låter dig skicka dina lokala nyheter till den avlägsna repo.

Till detta kommer vi att lägga till uppströms. För att göra detta, skaffa adressen till projektet du nyss delade. Alltid via url, eller knappen "Klona eller ladda ner".

Kommandot för att lägga till uppströms är: git remote add upstream \

Om du kör kommandot git remote -v igen, bör du nu se fyra poster. Två för ursprunget och två för uppströms. Varje duplicerad till en hämtning och en push.

ursprung https://github.com/DITT_ANVÄNDARNAMN/DITT_FORK.git (hämta) ursprung https://github.com/DITT_ANVÄNDARNAMN/DITT_FORK.git (push) uppströms https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (hämta) uppströms https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Du är redo att bidra nu!

Håll dig uppdaterad

(Steg är inte nödvändigt om du bara gaffelr.)

Chansen är stor att projektet du bidrar till inte är hugget i sten. Människorna som tar hand om det kommer att få det att utvecklas. Andra bidrag kommer potentiellt att accepteras.

Din repa kan därför snabbt bli inaktuell. Och det kan vara ett problem.

Om en fil ursprungligen innehöll "A" och du vill skicka ett bidrag för att ändra detta "A" till "B". Under tiden kanske någon annan har gjort en förändring från detta "A" till "C".

Och när du föreslår din ändring kommer det att uppstå en konflikt. Kan inte ändra "A" till "B" eftersom "A" inte längre finns i filen.

Kort sagt är det viktigt att hålla repan uppdaterad för att undvika obehagliga överraskningar.

Oroa dig inte, nu när du har konfigurerat uppströms, kommer det att vara en piece of cake!

Det första du ska göra är att skaffa den nya m