Repository navigation
GitHub Desktop
Om te beginnen met werken aan een GitHub project, moet je het clonen. Ga naar het project op de GitHub website, en vind de groene Code knop op de hoofdpagina. Hier kan je de URL van de repository kopiëren.
Dan open je GitHub Desktop en ga je naar jouw repositories.
Druk op Add en Clone repository.
Dan onder URL plak de URL en kies een lege map waar je jouw project wilt. Druk dan op Clone.
Het eerste wat je moet doen als je GitHub Desktop opent is fetchen, fetchen in GitHub Desktop vraagt Git for updates die jij nog niet lokaal binnen hebt. Als je nog niet up-to-date bent zal er Pull op de knop staan.
Let op: Fetch altijd for het committen of wanneer je een nieuwe branch op gaat.
Wanneer je op jouw huidige branch drukt, zal er een dropdown tevoorschijn komen met alle branches. Alle branches die beginnen met origin/ zijn remote branches. Als je op een branch drukt switch je naar die branch, als de branch remote is wordt het een lokale branch.
Wanneer je begint met werken aan een nieuwe user story, moet je een nieuwe branch aanmaken. Alle nieuwe branches moeten afstammen van de develop branch. Dus let goed op dat je op deze branch zit wanneer je een nieuwe branch aanmaakt.
Om een nieuwe branch aan te maken druk op new branch in de branches dropdown.
Let goed op dat je develop en niet main geselecteerd hebt (develop moet blauw zijn). Let ook op dat de branch de goede naamgeving volgen.
Als er een update is op de branch waar je op werkt moet je de nieuwe veranderingen pullen naar jouw lokale branch van de remote branch. Dit doe je door gewoon pull in te drukken. Let op: Pull altijd voor committen als het er staat na het fetchen.
Wanneer je switched van branches maar je nog veranderingen hebt op de originele branch kan je of de veranderingen stashen of ze overzetten naar de branch waar je naartoe switched.
Stashen betekent dat de veranderingen op de originele branch blijven maar niet remote of lokaal, maar in de stash. Als je wilt zien wat er in de stash staat druk je op view stash.
Het zou er ongeveer zo uit moeten zien:
Hier kan je kiezen voor een restore of discard. Door op restore te drukken breng je alle veranderingen uit de stash terug naar de lokale branch. Door op discard te drukken wordt alles in de stash terug gezet naar de laatste remote commit.
Wanneer je klaar bent met een een taak of als het het einde van de dag is, moet je al jouw nodige veranderingen committen. Door te committen maak je de veranderingen die je hebt gemaakt gereed voor de remote branch. In GitHub Desktop kan je een samenvatting en beschrijving schrijven. Wij schrijven alleen een samenvatting die de commit conventies volgen. Daarna druk je op commit to [branch name].
Als je jouw verandering hebt gecommit wordt de fetch knop boven in het scherm een push knop. door op push te drukken worden alle gecommitte veranderingen naar de remote branch over gebracht.
Onderaan de branch lijst druk je op choose a branch to merge into BRANCH NAME.
Kies de branch die je in je lokale branch wilt mergen (waarschijnlijk develop).
Dan push je de nieuwe merge als er geen merge conflicten zijn.
Als er een merge conflict is geeft GitHub deze melding.
Je kan een merge conflict oplossen door te kiezen of je het modified bestand van de lokale branch of de remote branch wilt gebruiken.
Let op: Je moet waarschijnlijk een paar dingen opnieuw aanpassen in de bestanden die merge conflicten hadden.
Als je klaar bent met de user story moet je een pull request aanmaken door preview pull request in te drukken.
Het zal een scherm als dit openen:
Kies de branch waar je jouw branch in wilt mergen (waarschijnlijk develop) en druk create pull request, Als het goed is word je naar de GitHub website gestuurd, hier volg je de pull request conventies.
