Bidra via Github

Forutsetninger

For å kunne bidra via pull-forespørsler er det flere forutsetninger:

Vet hvordan du bruker et minimum av Git
Har en Github-konto
Ha en del av prosjektet du ønsker å bidra til

Før du går inn i detaljene, vil det være nødvendig å gjøre et lite poeng om vokabularet. Her er en liten ordliste med ord som vi stadig bruker med Git/Github:

repo: Forkortelse av "Repository". Vi bruker dette ordet for å angi et sett med filer versjonert med Git.
gren: Dette er en gren i et Git-prosjekt. Grener lar deg lage en parallellversjon av koden på et tidspunkt i historien.
master: Angir hovedgrenen til repoen.
opprinnelse: Angir den eksterne repoen. Hostet på Github, for eksempel.
pull request: Dette er operasjonen som lar deg foreslå en kodemodifikasjon til et prosjekt på Github.
gaffel: Dette er en repo som er en kopi av en annen repo. Dette lar deg starte fra et eksisterende prosjekt for å endre det, forbedre det, korrigere det eller gjøre noe annet med det.
oppstrøms: Når det gjelder en gaffel, angir repoen som gaffelen kommer fra.
hente: Dette er operasjonen som består i å hente data fra fjernkontrollen lokalt.
push: Dette er operasjonen som lar lokale data sendes til fjernkontrollen.

Konfigurasjon

Gaffel

Det første du må gjøre er å gå til Github, for å lage en gaffel av prosjektet du ønsker å bidra til.

For å bidra til Leek Wars-klienten, gå for eksempel her: Leek Wars Client

Deretter klikker du bare på "gaffel"-knappen øverst til høyre.

Ved å "fordele" prosjektet vil Github opprette en ny repo på kontoen din. Dette vil være en kopi av det originale prosjektet.

Få deretter adressen til din github-repo, via url-adressen, eller ved å klikke på den grønne "Klon eller last ned"-knappen.

Gå til stedet der du vil plassere din lokale repo og bruk kommandoen: git clone \ Ikke glem å erstatte "\".

Så. Du har opprettet en gaffel av prosjektet og du har hentet den lokalt, på maskinen din. Men det er en ting til for å kunne fortsette å bruke den uten bekymringer i fremtiden.

Oppstrøm

Du må deretter konfigurere oppstrøms, som lar deg oppdatere repoen din fra prosjektet.

Kommandoen git remote -v lar deg liste opp de konfigurerte fjernadressene.

opprinnelse https://github.com/DITT_BRUKERNAVN/DITT_FORK.git (hent) opprinnelse https://github.com/DITT_BRUKERNAVN/DITT_FORK.git (push)

Foreløpig bør du se to adresser konfigurert som opprinnelse. En i henting, når du ønsker å repatriere nye funksjoner fra fjernkontrollen, er repoen din vert på Github. Og den andre i push som omvendt lar deg sende dine lokale nyheter til den eksterne repoen.

Til dette vil vi legge til oppstrøms. For å gjøre dette, få adressen til prosjektet du nettopp gaffel. Alltid via url, eller "Klon eller last ned"-knappen.

Kommandoen for å legge til oppstrøms er: git remote add upstream \

Hvis du kjører kommandoen git remote -v igjen, bør du nå se fire oppføringer. To for opprinnelsen og to for oppstrøms. Hver duplisert til en fetch og en push.

opprinnelse https://github.com/DITT_BRUKERNAVN/DITT_FORK.git (hent) opprinnelse https://github.com/DITT_BRUKERNAVN/DITT_FORK.git (push) oppstrøms https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (hent) oppstrøms https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Du er klar til å bidra nå!

Hold deg oppdatert

(Trinn er ikke nødvendig hvis du bare gaffeler.)

Sjansen er stor for at prosjektet du bidrar til ikke er hugget i stein. Menneskene som tar seg av det vil få det til å utvikle seg. Andre bidrag vil potensielt bli akseptert.

Din repo kan derfor fort bli foreldet. Og det kan være et problem.

Hvis en fil opprinnelig inneholdt "A", og du ønsker å sende inn et bidrag for å endre denne "A" til "B". I mellomtiden vil kanskje noen andre ha gjort en endring fra denne "A" til "C".

Og når du foreslår endringen din, vil det oppstå en konflikt. Kan ikke endre "A" til "B" siden "A" ikke lenger finnes i filen.

Kort fortalt er det viktig å holde repoen oppdatert for å unngå ubehagelige overraskelser.

Ikke bekymre deg, nå som du har konfigurert oppstrøms, blir det en piece of cake!

Det første du må gjøre er å få den nye m