User stories

Je stelt eigen user stories op vanuit inzichten uit de test met eindgebruikers en houdt deze bij in het Issue Board van GitLab. Je maakt voor elke user story een issue aan in GitLab, voorziet die van een duidelijke beschrijving en acceptatiecriteria, en gebruikt het board om de voortgang te volgen en te presenteren tijdens product reviews. Je werkt de stories uit in je product en zorgt ervoor dat ze aansluiten bij UX-standaarden en best practices. Dit product past bij de leeruitkomst Gebruikersinteractie.

User stories beschrijven wat een gebruiker wil kunnen doen, in de vorm “Als [rol] wil ik [actie] zodat [waarde]”. Ze komen voort uit TMC-cycli en gebruikersonderzoek. Door ze als issues in het GitLab Issue Board te zetten, heb je één plek waar het team en de product owner kunnen zien welke stories er zijn, wat de status is en wat de acceptatiecriteria zijn. Het board gebruik je om te plannen, te prioriteren en de iteraties aan de product owner te tonen.

User stories in het GitLab Issue Board

Het Issue Board in GitLab werkt met issues: elke user story is een issue. Je geeft het issue een titel (kort, in de vorm van de story) en in de beschrijving zet je de volledige formulering “Als [rol] wil ik [actie] zodat [waarde]”, plus de acceptatiecriteria. Je kunt labels gebruiken om stories te groeperen en milestones om ze aan een sprint koppelen.

Op het board sleep je issues van de ene kolom naar de andere (bijv. To Do → In progress → Done). Zo is voor iedereen zichtbaar welke stories in welke fase zitten. Tijdens de product review kun je het board gebruiken om te laten zien wat er is opgeleverd en wat er nog staat. Zorg dat je project een Issue Board heeft ingericht en dat alle user stories daar als issues terugkomen.

Aan User Stories koppel je taken die je moet uitvoeren om de story te implementeren. Je maakt hiervoor gebruik van de Tasks feature in Gitlab.

Kwaliteitsindicatoren

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

• User stories staan als issues in het Issue Board van GitLab van het project, met een duidelijke koppeling naar het product.
• Elke user story (issue) is geformuleerd vanuit het perspectief van de eindgebruiker (rol, actie, waarde) en heeft een duidelijke titel en beschrijving.
• De stories zijn afgeleid van inzichten uit tests of gebruikersonderzoek (TMC, interviews); dit is waar mogelijk in de issue of bij de story vermeld.
• Er zijn meerdere Tasks per story opgenomen (in de Tasks feature van GitLab).
• Er zijn acceptatiecriteria per story opgenomen (in de beschrijving van het GitLab-issue).
• Het board wordt gebruikt om de voortgang bij te houden (status van issues is actueel) en de stories zijn waar relevant uitgewerkt in het product.
• Er is presentatie of afstemming met de product owner over de iteraties, waarbij het Issue Board kan worden gebruikt.
• Er is aandacht voor UX-standaarden en best practices bij de formulering en uitwerking van de stories.

Template

Om user stories in GitLab te documenteren en te presenteren, kan je gebruik maken van de volgende aanpak:

# User stories in het GitLab Issue Board: [product / project]

Korte introductie: wat is het doel van de user stories en hoe zijn ze tot stand gekomen (TMC, onderzoek)? Verwijs naar het GitLab-project en het Issue Board.

## Gebruik van het Issue Board

- Link naar het Issue Board van het project.
- Welke labels of milestones gebruik je voor user stories?
- Hoe volgen jullie de status (kolommen op het board)?

## Overzicht user stories (uit GitLab)

Je kunt een overzichtstabel opnemen die verwijst naar de issues in GitLab:

| Issue   | Als [rol] wil ik [actie] zodat [waarde]         | Sprint          |
|---------|-------------------------------------------------|-----------------|
| #12     | Als bezoeker wil ik kunnen inloggen zodat ik... | Sprint 2        |
| ...     | ...                                             | ...             |

Of verwijs naar het board: "Zie het Issue Board in GitLab voor het actuele overzicht."

## Voorbeeld van een GitLab-issue (user story)

**Titel:** Als *bezoeker* wil ik *kunnen inloggen met e-mail en wachtwoord* zodat *ik mijn persoonlijke gegevens kan zien*.

**Beschrijving:**
Gebruikers wordt gevraagd om een e-mailadres en wachtwoord in te vullen om in te kunnen loggen. 
Bij juiste gegevens wordt de gebruiker doorgestuurd naar het dashboard. 
Bij foute gegevens wordt een duidelijke foutmelding getoond.


**Acceptatiecriteria:**
- [ ] Er is een inlogformulier met velden e-mail en wachtwoord.
- [ ] Bij juiste gegevens wordt de gebruiker doorgestuurd naar het dashboard.
- [ ] Bij foute gegevens wordt een duidelijke foutmelding getoond.

**Labels:** user-story, sprint-2  
**Milestone:** Sprint 2

## Iteraties en product review

Welke iteraties heb je doorlopen en wat heb je aan de product owner gepresenteerd (eventueel aan de hand van het board)? Welke feedback is meegenomen in nieuwe of aangepaste issues?