Schrijven van duidelijke vereisten
Hoofdstuk 3: Technieken voor glasheldere communicatie
Schrijf als een professional: duidelijke, bruikbare vereisten
Het SMART-framework
Elke vereiste moet zijn:
- Specifiek: Geen onduidelijkheid over wat nodig is
- Meetbaar: Duidelijke criteria voor voltooiing
- Haalbaar: Technisch haalbaar met de beschikbare middelen
- Relevant: Ondersteunt direct bedrijfsdoelstellingen
- Testbaar: Kan worden geverifieerd wanneer voltooid
Do's en don'ts
DOEN
Gebruik actieve stem:
"Het systeem stuurt een e-mail wanneer de voorraad het minimumniveau bereikt"
NIET DOEN
Gebruik passieve stem:
"Er moet een e-mail worden verzonden wanneer de minimumniveaus zijn bereikt"
DOEN
Wees specifiek met cijfers:
"De responstijd moet voor 95% van de vragen minder dan 2 seconden zijn"
NIET DOEN
Gebruik vage termen:
‘Het systeem moet snel zijn’
DOEN
Termen definiëren:
"Actieve klant: elke klant met een aankoop in de afgelopen 90 dagen"
NIET DOEN
Ga uit van begrip:
"Toon actieve klanten" (Wat maakt een klant actief?)
Krachtwoorden voor vereisten
Gebruik deze actiewoorden:
- Berekenen, valideren, genereren
- Weergeven, verbergen, inschakelen, uitschakelen
- Maken, bijwerken, verwijderen, archiveren
- Verzenden, ontvangen, verwerken, opslaan
- Authenticeren, autoriseren, loggen
Vermijd deze vage termen:
- "Gebruiksvriendelijk" (wees specifiek)
- "Flexibel" (definieer de flexibiliteit)
- "Intuïtief" (beschrijf de stroom)
- "Robuust" (foutafhandeling specificeren)
- "Enz." (lijst alles)
Het gebruikersverhaalformaat
Als [gebruikerstype] wil ik [actie] ondernemen, zodat [voordeel]
Voorbeelden:
- "Als magazijnbeheerder wil ik meldingen over lage voorraad op mijn dashboard zien, zodat ik kan bijbestellen voordat de voorraad op is"
- "Als verkoper wil ik tijdens telefoongesprekken realtime de voorraad controleren, zodat ik nauwkeurige leveringsdata kan beloven"
- "Als accountant wil ik geautomatiseerde voorraadwaarderapportages, zodat ik maandelijks sneller boeken kan afsluiten"
Sjabloon voor acceptatiecriteria
Gegeven [oorspronkelijke context]
Wanneer [actie plaatsvindt]
Dan [verwachte uitkomst]
Voorbeeld:
Gegeven een product met een minimaal voorraadniveau van 50 eenheden
Wanneer het beschikbare aantal daalt tot 50 of minder
Vervolgens stuurt het systeem binnen 5 minuten een e-mail naar de magazijnbeheerder