Hoe werkt GitHub voor beginners? Je eerste repository en commit

GitHub is een online platform waarop je bestanden en programmeercode kunt opslaan, beheren en delen. GitHub voor beginners draait vooral om drie dingen: projecten organiseren, wijzigingen bijhouden en samenwerken met anderen.

Stel dat je een website maakt. Je begint met een eenvoudige pagina, maar later voeg je nieuwe functies toe. Met GitHub kun je precies zien wat je hebt aangepast en wanneer. Maak je een fout? Dan kun je eerdere versies van je bestanden terugvinden.

GitHub wordt veel gebruikt door softwareontwikkelaars, maar ook IT-studenten en systeembeheerders kunnen ermee werken. Je hebt bovendien geen programmeerkennis nodig om de basis te leren.

Git en GitHub zijn niet hetzelfde. Git is een programma voor versiebeheer waarmee je wijzigingen in bestanden bijhoudt. GitHub is een online platform dat Git gebruikt om projecten op te slaan en samenwerking mogelijk te maken.

Het belangrijkste verschil is dat Git ook zonder internet en zonder GitHub werkt. GitHub voegt functies toe waarmee je bijvoorbeeld code kunt delen, wijzigingen kunt bespreken en samen aan projecten kunt werken.

Wil je meer weten over versiebeheer? Lees dan onze uitgebreide uitleg over wat Git is en hoe het werkt.

Wil je naast Git ook de mogelijkheden van GitHub leren kennen? Dan is de training GitHub Foundations (GH-900) een passende vervolgstap.

Om GitHub te gebruiken, heb je een persoonlijk account nodig. Je kunt gratis een account aanmaken en direct beginnen met je eerste project.

Een account aanmaken werkt als volgt:

• Ga naar github.com.
• Klik op Sign up.
• Vul je e-mailadres in of kies een beschikbare aanmeldmethode.
• Volg de stappen om je account aan te maken.
• Bevestig je e-mailadres wanneer GitHub daarom vraagt.

Na het aanmelden kom je in de GitHub-omgeving terecht. Hier kun je repositories aanmaken, projecten bekijken en je account beheren.

Het is verstandig om ook tweestapsverificatie in te schakelen. Daarmee maak je je account beter bestand tegen ongewenste toegang.

Een repository is een opslagplaats voor de bestanden van een project. Je bewaart hierin bijvoorbeeld programmeercode, documentatie en de geschiedenis van wijzigingen.

We gaan een eenvoudige repository maken. Hiervoor hoef je niets te installeren.

1. Maak een nieuwe repository aan.
   Klik rechtsboven op het plusteken (+) en kies ‘New repository’.
2. Geef je repository een naam.
   Vul bijvoorbeeld mijn-eerste-project in. Je kunt ook een korte beschrijving toevoegen.
3. Kies de zichtbaarheid.
   Selecteer ‘Public’ als iedereen het project mag bekijken of ‘Private’ als je de toegang wilt beperken.
4. Voeg een README-bestand toe.
   Vink ‘Add a README file’ aan. Hierin kun je uitleggen waar je project over gaat.
5. Maak de repository aan.
   Klik op ‘Create repository’. Je eerste GitHub-project is nu aangemaakt.

Je ziet nu een overzicht met je bestanden. Het README-bestand heet README.md en wordt meestal gebruikt om een project te beschrijven.

Je hebt nu je eerste repository gemaakt. De volgende stap is een bestand aanpassen en die wijziging opslaan.

Een commit is een opgeslagen wijziging in je project. GitHub bewaart daarbij wat er is veranderd en welke beschrijving je aan die wijziging hebt gegeven.

Je kunt een commit vergelijken met een opgeslagen tussenstand van je werk. Zo kun je later terugvinden hoe je project is veranderd.

We gaan nu je README-bestand aanpassen.

• Open de repository mijn-eerste-project.
• Klik op het bestand README.md.
• Klik op het potloodicoontje om het bestand te bewerken.
• Voeg bijvoorbeeld deze tekst toe:Dit is mijn eerste GitHub-project. Hier leer ik werken met repositories en commits.
• Klik rechtsboven op Commit changes.
• Vul als commitbericht README bijgewerkt in.
• Kies ervoor om de wijziging direct op de main-branch op te slaan en bevestig met Commit changes.

Je hebt nu je eerste commit gemaakt!

Open het onderdeel ‘Commits’ of de geschiedenis van je repository om je wijziging terug te zien.

Tip: gebruik duidelijke commitberichten, zoals ‘Contactpagina toegevoegd’ of ‘Fout in navigatie opgelost’. Zo begrijp je later waarom je iets hebt aangepast.

Een branch is een aparte ontwikkellijn binnen je repository. Daarmee kun je wijzigingen maken zonder direct de hoofdversie van je project aan te passen. Een pull request gebruik je vervolgens om voor te stellen die wijzigingen samen te voegen.

Dit is een belangrijk onderdeel van samenwerken op GitHub.

Stap 1: Maak een nieuwe branch

Open je repository en klik op de knop waar main staat. Typ nieuwe-functie en kies de optie om een nieuwe branch vanuit main aan te maken.

Je hebt nu een aparte versie van je project waarin je veilig kunt oefenen.

Stap 2: Pas een bestand aan

Open opnieuw het bestand README.md. Voeg een extra regel toe, bijvoorbeeld:

In dit project oefen ik ook met branches en pull requests.

Sla je wijziging op met een nieuwe commit. Controleer daarbij dat je commit op de branch nieuwe-functie terechtkomt.

Stap 3: Maak een pull request

Ga naar het tabblad Pull requests en kies New pull request.

Selecteer main als doelbranch en nieuwe-functie als branch met jouw wijzigingen. Controleer het verschil tussen beide versies en klik op Create pull request.

Geef je verzoek een duidelijke naam en bevestig het aanmaken.

Stap 4: Voeg de wijzigingen samen

Je kunt nu bekijken welke veranderingen je hebt voorgesteld. In een ontwikkelteam kan een collega deze eerst controleren.

Omdat dit je eigen oefenproject is, kun je zelf op Merge pull request klikken. Bevestig de samenvoeging.

Je wijziging staat nu ook in de hoofdbranch.

Met deze oefening heb je de basis van samenwerken op GitHub doorlopen. Wil je ook leren werken met lokale Git-omgevingen en uitgebreidere branching-strategieën? Bekijk dan de Git Fundamentals Training.

Beginners maken op GitHub vaak dezelfde fouten. De belangrijkste zijn onduidelijke commitberichten, werken op de verkeerde branch en het openbaar maken van gevoelige informatie.

Let vooral op de volgende situaties:

1. Onduidelijke commitberichten gebruiken.
   Een bericht zoals ‘Update’ vertelt weinig. Beschrijf liever wat je hebt veranderd.
2. Op de verkeerde branch werken.
   Controleer voordat je bestanden aanpast of je op de juiste branch zit. Zo voorkom je ongewenste wijzigingen.
3. Gevoelige informatie uploaden.
   Plaats nooit wachtwoorden, API-sleutels of andere geheime gegevens in je repository. Ook niet als je deze later weer verwijdert.
4. Geen README-bestand toevoegen.
   Zonder uitleg is voor anderen vaak onduidelijk wat je project doet. Gebruik een README om je project kort te beschrijven.

Door vanaf het begin zorgvuldig te werken, voorkom je problemen wanneer je later met grotere projecten aan de slag gaat.

Je kunt GitHub zelf leren door kleine projecten te maken en steeds nieuwe functies uit te proberen. Begin met repositories, commits en pull requests. Daarna kun je leren werken met code reviews, projectbeheer en automatisering.

Wil je GitHub gebruiken binnen een professioneel ontwikkelteam? Dan is het belangrijk dat je niet alleen de knoppen kent, maar ook begrijpt hoe je veilig en overzichtelijk samenwerkt.

Bij Startel kun je hiervoor de GitHub Foundations (GH-900) training volgen. Je leert onder andere werken met repositories, branches, pull requests, GitHub Copilot en Codespaces.

Met ruim 25 jaar ervaring in IT-opleidingen helpt Startel professionals om hun technische kennis verder te ontwikkelen.

Conclusie: GitHub leren begint met oefenen. Maak een repository, pas een bestand aan en voer een commit uit. Zodra je ook met branches en pull requests kunt werken, heb je een goede basis om aan grotere projecten mee te doen.