Modules/Git-0

Github en Git

Versie beheer van je code

Module bij de badge: Badges/Git-0

Deze module is nog in bewerking.

Intro

Bij ICT in de wolken werken we regelmatig aan projecten waarbij je veel code moet schrijven. Maar wat nu als je een paar weken een fout maakt en je kunt de (nog) wel werkende versie van je code niet meer terug vinden? Of je verwijderd per ongeluk het werkende bestand? Om je deze frustratie te besparen leren we je werken met Github. Dit is een website waar je je projecten versie voor versie kunt opslaan. En werkt het niet meer? Dan kun je je versie die nog wel werkte gewoon terug vinden op de site. Een ander voordeel is dat je gemakkelijk op verschillende pc’s kunt samenwerken aan je project. Zo kan je teamgenoot ook de code bekijken, bewerken en een nieuwe versie aanmaken.

Doelen

Kennis: Je kent de verschillende basis-commando’s in de terminal om een project van Github te halen en op Github te zetten. Je kunt code samenvoegen.

Kunde: Je kunt een project starten en bewerken op Github. Je kunt op Github samenwerken met je teamgenoten.

Gedrag: Je pushed consequent en regelmatig een nieuwe versie van je code naar Github. Je voegt een duidelijke beschrijving toe wat je veranderd hebt. Waar nodig kijk je de code van je projectleden na.

Opdracht in het kort

We leren je tijdens deze module hoe je een project op Github start en hoe je ermee werkt. Je kunt dit toepassen tijdens je andere projecten die je voor ICT in de wolken doet.

Je hebt nodig

• Mac OSX: Terminal

of

• Linux: Terminal

of

• Windows: [Git for Windows](https://git-for-windows.github.io)

en

• Je hebt een account nodig op Github. Je kunt hiervoor je ICT in de wolken e-mailadres gebruiken.

Opdracht: Werken op Github

Een account aanmaken op Github

Als je dit nog niet hebt is dit het juiste moment om er een aan te maken. Je zult merken hoe handig Github is voor je projecten.

Een repository aanmaken

Een repository is een manier om je project te organiseren. Alle verschillende bestanden die nodig zijn voor je project worden hierin geplaatst. Het is handig om een READ-ME bestand te maken om uit te leggen wat je project is, wat het doet en hoe het te gebruiken is.

1. Ga naar: [1](github.com/<jegebruikersnaam>)

2. Rechtsboven, naast je avatar zie je een + symbool. Klik hierop en kies New repository.

3. Geef de repository de naam “hello-world”

4. Geef de repository een beschrijving. Bijvoorbeeld: test repository.

5. Selecteer Initialize this repository with a README.

Plaatje

Een branch aanmaken

Waarschijnlijk heb je bij een groot werkstuk wel eens de hoofdstukken in aparte documenten gezet: Inleiding.docx, Literatuur onderzoek.docx, Resultaten.docx. Of bij het nakijken door verschillende personen heb je aparte bestanden: Werkstuk_nagekeken_door_piet.docx, Werkstuk_nagekeken_door_mamma.docx. Meestal wordt een branch gebruikt om een functie toe te voegen aan je code. Je kopieert hiervoor de originele code (master), en voegt een nieuwe functie in de branch toe. De branch kun je dan later weer toevoegen aan de originele code. Zo kun je aan je werkstuk hoofdstukken apart toevoegen en je moeder kan jouw originele werkstuk nakijken in een nieuwe branch.

1. Om een nieuwe branch aan te maken ga je eerst naar je repository.

2. Klik op het dropdown menu waar “Branch: master” staat.

3. Kies een naam voor je branch, bijvoorbeeld: readme-edits.

4. Klik op Create branch of druk op Enter

Plaatje

Je hebt nu twee dezelfde branches, maar de readme-edits gaan we veranderen.

Maak een verandering en doe een commit

Je hebt al een read-me bestand aangemaakt in de repository. Dit bestand kunnen we op de site van Github aanpassen.

1. Klik op het README.md bestand.

2. Klik op het potloodjes rechts in het scherm.

3. Je ziet nu de editor waar je in kunt schrijven. Schrijf in het bestand wat informatie over jezelf.

4. Als je naar beneden scrollt kun je een beschrijving toevoegen aan wat je hebt veranderd.

5. Klik nu op Commit changes.

Plaatje

De readme-edits branch verschilt nu van de master branch. We gaan ze nu weer gelijk maken.

Open een pull request

Github merkt zelf dat er een verandering is ontstaan tussen de nieuwe branch en de master branch. Op de homepagina van je repository staat nu een optie Compare & pull request. In het is ook mogelijk om anderen je code te laten beoordelen voordat de code wordt samengevoegd met de master branch. Je kunt hiervoor andere Github gebruikers noemen met het @mention systeem.

1. Klik op het Pull request tabblad.

2. Klik op New pull request.

3. Selecteer de branches die je wilt vergelijken. In dit geval de readme-edits en de master.

4. Bekijk de veranderingen. Klopt het wat je wil veranderen en definitief wilt maken in de master branch?

5. Als je tevreden bent met de veranderingen klik dan op de groene knop Create Pull Request.

6. Geef een korte omschrijving mee en maak de pull request definitief.

Plaatje

Merge het pull request

Nu je de veranderingen hebt bekeken, kunnen we de branches samenvoegen.

1. Klik op de groene knop waarop staat Merge pull request.

2. Klik op Confirm merge.

3. Verwijder nu de branch waar je de veranderingen in hebt gedaan. Klik op Delete branch. Je readme-edits branche is nu opgegaan in de master branch.

Opdracht: Werken met Git en Github

Je weet nu hoe je op Github een project aan kunt maken, hoe je branches aanmaakt en hoe je code kunt samenvoegen in de master branch. Je werkt vaak lokaal op je eigen computer aan je code. Dit kun je naar de Github-website uploaden. Dat gaat eigenlijk best gemakkelijk, helemaal als je weet hoe de command line interface werkt.

Het is belangrijk om te weten dat Git en Github twee verschillende dingen zijn.

Configuratie van Git op je computer

Je weet nu hoe je op Github een project aan kunt maken, hoe je branches aanmaakt en hoe je code kunt samenvoegen in de master branch. Je werkt vaak lokaal op je eigen computer aan je code. Dit kun je naar de Github-website uploaden. Dat gaat eigenlijk best gemakkelijk, helemaal als je weet hoe de command line interface werkt.

Het is belangrijk om te weten dat Git en Github twee verschillende dingen zijn.

Link naar document

[2](Document voor opdracht)

Samenwerken

Als je samen werkt aan projecten, met verschillende computers en verschillende accounts moet je er aan denken dat de code kan veranderen terwijl jij ergens aan werkt. Je doet er goed aan om voordat je aan een branch gaat werken, eventueel nieuwe code op te halen met het commando git pull. Hiermee haal je de meest recente versie op. Als er tegelijk aan een branch wordt gewerkt moet je dit ook doen voordat je je code overzet naar de staging directory.

Als je samenwerkt is het ook fijn om elkaar code even te controleren op Github. Nadat iemand een pull request heeft gedaan naar een andere branch, kan iemand anders de code bekijken en beoordelen? Is het team het ermee eens? Dan merge je het pull request.

Extra Links

[3](https://guides.github.com)

[4](http://www.codepancake.com/introduction-to-git/)

[5](https://www.codecademy.com/learn/learn-git)

[6](https://wheelhouseio.github.io/patchwork/)

[7](https://services.github.com/kit/downloads/github-git-cheat-sheet.pdf)