Draag bij via Github

Vereisten

Om via pull-aanvragen te kunnen bijdragen, zijn er verschillende vereisten:

Weet hoe je minimaal Git moet gebruiken
Heb een Github-account
Heb een vork van het project waaraan u wilt bijdragen

Alvorens op de details in te gaan, is het nodig een kleine opmerking over de woordenschat te maken. Hier is een kleine verklarende woordenlijst van woorden die we constant gebruiken met Git/Github:

repo: Afkorting van "Repository". We gebruiken dit woord om een set bestanden aan te duiden waarvan een versie is gemaakt met Git.
branch: Dit is een branch in een Git-project. Met branches kunt u op een bepaald moment in de geschiedenis een parallelle versie van de code maken.
master: Geeft de hoofdtak van de repo aan.
oorsprong: Geeft de externe opslagplaats aan. Gehost op bijvoorbeeld Github.
pull request: dit is de bewerking waarmee u een codewijziging aan een project op Github kunt voorstellen.
fork: Dit is een repo die een kopie is van een andere repo. Hierdoor kunt u vertrekken van een bestaand project om het aan te passen, te verbeteren, te corrigeren of er iets anders mee te doen.
stroomopwaarts: in het geval van een vork, geeft dit de repo aan waar de vork vandaan komt.
ophalen: dit is de bewerking die bestaat uit het lokaal ophalen van gegevens van de afstandsbediening.
push: Dit is de handeling waarmee lokale gegevens naar de afstandsbediening kunnen worden verzonden.

Configuratie

Vork

Het eerste dat u moet doen, is naar Github gaan om een afsplitsing te maken van het project waaraan u wilt bijdragen.

Als u bijvoorbeeld wilt bijdragen aan de Leek Wars-client, gaat u hier: Leek Wars-client

Klik vervolgens op de knop "vork" rechtsboven.

Door het project te 'forken', maakt Github een nieuwe repo op je account aan. Dit is een kopie van het originele project.

Haal dan het adres van je github-repo op, via het url-adres, of door op de groene knop "Klonen of downloaden" te klikken.

Ga naar de locatie waar u uw lokale repo wilt plaatsen en gebruik de opdracht: git clone \ Vergeet niet "\" te vervangen.

Alstublieft. U hebt een afsplitsing van het project gemaakt en u hebt deze lokaal op uw computer opgehaald. Maar er is nog één ding te doen om het in de toekomst zonder zorgen te kunnen blijven gebruiken.

Stroomopwaarts

U moet vervolgens de upstream configureren, waarmee u uw repo kunt bijwerken vanaf de projectrepo.

Met het commando git remote -v kun je de geconfigureerde externe adressen weergeven.

herkomst https://github.com/YOUR_USERNAME/YOUR_FORK.git (ophalen) oorsprong https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

Voor nu zou u twee adressen moeten zien die zijn geconfigureerd als oorsprong. Eén in fetch, wanneer u nieuwe functies wilt repatriëren vanaf uw remote, uw repo gehost op Github. En de andere in push waarmee u daarentegen uw lokale nieuws naar de externe repo kunt sturen.

Hier voegen we de upstream aan toe. Om dit te doen, krijgt u het adres van het project dat u zojuist hebt gesplitst. Altijd via de url, of de knop "Klonen of downloaden".

Het commando om de upstream toe te voegen is: git remote add upstream \

Als je het git remote -v commando nogmaals uitvoert, zou je nu vier ingangen moeten zien. Twee voor de oorsprong en twee voor de stroomopwaarts. Elk gedupliceerd in een fetch en een push.

herkomst https://github.com/YOUR_USERNAME/YOUR_FORK.git (ophalen) oorsprong https://github.com/YOUR_USERNAME/YOUR_FORK.git (push) stroomopwaarts https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (ophalen) stroomopwaarts https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

U bent nu klaar om bij te dragen!

Op de hoogte blijven

(Stap niet nodig als je gewoon vorkt.)

De kans is groot dat het project waaraan u bijdraagt niet in steen gebeiteld is. De mensen die ervoor zorgen, zullen het laten evolueren. Andere bijdragen worden mogelijk geaccepteerd.

Uw repo kan daardoor snel verouderd raken. En dat kan een probleem zijn.

Als een bestand oorspronkelijk "A" bevatte en u wilt een bijdrage indienen, wijzigt u deze "A" in "B". In de tussentijd heeft misschien iemand anders een wijziging aangebracht van deze "A" naar "C".

En wanneer u uw wijziging voorstelt, ontstaat er een conflict. Kan "A" niet wijzigen in "B" aangezien "A" niet langer aanwezig is in het bestand.

Kortom, het is belangrijk om de repo up-to-date te houden om onaangename verrassingen te voorkomen.

Maak je geen zorgen, nu je de upstream hebt geconfigureerd, is het een fluitje van een cent!

Het eerste dat u moet doen, is de nieuwe m aanschaffen