Skip to content
ICT Fusion Knowledgebase

GitLab en samenwerkingsafspraken

Je beheert het software-ontwikkelproces in GitLab met behulp van gangbare samenwerkingsafspraken. Je houdt je aan afspraken over branching, commits, merge requests en code reviews, zodat het team goed kan samenwerken aan de codebase. Dit product past bij de leeruitkomst Software.

GitLab wordt gebruikt voor versiebeheer, samenwerking en vaak ook voor issue tracking en CI/CD. Door afspraken vast te leggen over hoe je branches gebruikt, hoe je commit messages schrijft, en hoe je merge requests en reviews doorloopt, voorkom je conflicten en houd je de kwaliteit hoog. Dit product kan bestaan uit een document met afspraken en eventueel voorbeelden of verwijzingen naar de repository.

Kwaliteitsindicatoren

Bij het waarderen van dit product zal er worden gekeken naar de volgende kwaliteitsindicatoren:

  • Er is een op zichzelf staand document of een duidelijk onderdeel in projectdocumentatie over GitLab en samenwerking.
  • Er zijn afspraken over branching (bijv. main/develop, feature branches, naamgeving).
  • Er zijn afspraken over commits (bijv. duidelijke commit messages, geen direct op main pushen).
  • Er zijn afspraken over merge requests en code review (wanneer, door wie, wat wordt gecontroleerd).
  • De afspraken worden in de praktijk nageleefd (zichtbaar in de repository of in beoordeling).
  • Er is een koppeling met het team en het software-ontwikkelproces.
  • Eventueel: er is verwezen naar de GitLab-repository of voorbeelden van goede commits/MR’s.

Template

Om GitLab en samenwerkingsafspraken te documenteren, kan je gebruik maken van de volgende template:

# GitLab en samenwerkingsafspraken

Korte introductie: voor welk project en welk team gelden deze afspraken? Waar staat de repository?

## Branching

- Welke branches gebruiken we? (main, develop, feature/..., fix/...)
- Hoe noemen we branches? Wanneer maken we een nieuwe branch?

## Commits

- Hoe schrijven we commit messages? (bijv. kort en beschrijvend, in de gebiedende wijs)
- Pushen we direct op main of altijd via merge request?

## Merge requests en code review

- Wanneer openen we een merge request? Wat moet erin staan (beschrijving, link naar issue)?
- Wie doet code review? Waar letten we op?
- Wanneer mergen we?

## Overige afspraken

Eventueel: issues, labels, milestones, CI/CD, wie heeft rechten.