Bidrag via Github

Forudsætninger

For at kunne bidrage via pull-anmodninger er der flere forudsætninger:

Vide, hvordan man bruger et minimum af Git
Har en Github-konto
Hav en forgrening af det projekt, du ønsker at bidrage til

Før du går ind i detaljerne, vil det være nødvendigt at gøre et lille punktum om ordforrådet. Her er en lille ordliste, som vi konstant bruger med Git/Github:

repo: Forkortelse af "Repository". Vi bruger dette ord til at udpege et sæt filer versioneret med Git.
gren: Dette er en gren i et Git-projekt. Filialer giver dig mulighed for at oprette en parallel version af koden på et tidspunkt i historien.
master: Udpeger hovedgrenen af repoen.
Oprindelse: Angiver den eksterne repo. Hostet på Github, for eksempel.
pull request: Dette er den operation, der giver dig mulighed for at foreslå en kodeændring til et projekt på Github.
gaffel: Dette er en repo, der er en kopi af en anden repo. Dette giver dig mulighed for at starte fra et eksisterende projekt for at ændre det, forbedre det, rette det eller gøre noget andet med det.
opstrøms: I tilfælde af en gaffel, angiver den repo, hvorfra gaflen kommer.
Hent: Dette er operationen, der består i at hente data fra fjernbetjeningen lokalt.
push: Dette er den handling, der gør det muligt at sende lokale data til fjernbetjeningen.

Konfiguration

Fork

Den første ting at gøre er at gå til Github for at skabe en gaffel af det projekt, som du ønsker at bidrage til.

For at bidrage til Leek Wars-klienten kan du f.eks. gå her: Leek Wars Client

Klik derefter på "gaffel"-knappen øverst til højre.

Ved at "forke" projektet, vil Github oprette en ny repo på din konto. Dette vil være en kopi af det originale projekt.

Så få adressen på din github repo, via url-adressen, eller ved at klikke på den grønne "Klon eller download" knap.

Gå til det sted, hvor du vil placere din lokale repo, og brug kommandoen: git clone \ Glem ikke at erstatte "\".

Så. Du har oprettet en gaffel af projektet, og du har hentet den lokalt på din maskine. Men der er en ting mere at gøre for at kunne fortsætte med at bruge det uden bekymringer i fremtiden.

Opstrøms

Du skal derefter konfigurere upstream, som giver dig mulighed for at opdatere din repo fra projektet.

Kommandoen git remote -v giver dig mulighed for at liste de konfigurerede fjernadresser.

oprindelse https://github.com/YOUR_USERNAME/YOUR_FORK.git (hent) oprindelse https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

Indtil videre bør du se to adresser konfigureret som oprindelse. Én i hentning, når du ønsker at hjemtage nye funktioner fra din fjernbetjening, din repo hostet på Github. Og den anden i push, som omvendt giver dig mulighed for at sende dine lokale nyheder til den eksterne repo.

Til dette vil vi tilføje opstrøms. For at gøre dette skal du få adressen på det projekt, du lige har splittet. Altid via url'en, eller knappen "Klon eller download".

Kommandoen til at tilføje upstream er: git remote add upstream \

Hvis du kører kommandoen git remote -v igen, skulle du nu se fire poster. To for oprindelsen og to for opstrøms. Hver duplikeret til en fetch og en push.

oprindelse https://github.com/YOUR_USERNAME/YOUR_FORK.git (hent) oprindelse https://github.com/YOUR_USERNAME/YOUR_FORK.git (push) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (hent) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Du er klar til at bidrage nu!

Hold dig opdateret

(Trin er ikke nødvendigt, hvis du bare gafler.)

Chancerne er, at det projekt, du bidrager til, ikke er hugget i sten. De mennesker, der tager sig af det, vil få det til at udvikle sig. Andre bidrag vil potentielt blive accepteret.

Din repo kan derfor hurtigt blive forældet. Og det kan være et problem.

Hvis en fil oprindeligt indeholdt "A", og du ønsker at indsende et bidrag til at ændre dette "A" til "B". I mellemtiden vil måske en anden have lavet en ændring fra dette "A" til "C".

Og når du foreslår din ændring, vil der være en konflikt. Kan ikke ændre "A" til "B", da "A" ikke længere findes i filen.

Kort sagt er det vigtigt at holde repoen opdateret for at undgå ubehagelige overraskelser.

Bare rolig, nu hvor du har konfigureret upstream, vil det være et stykke kage!

Det første du skal gøre er at få den nye m