Hoe verwoord je de feedback?

Schrijf vanuit jezelf

Schrijf altijd in de eerste persoon en in jouw eigen woorden. Je hoeft de feedback niet letterlijk over te nemen — parafraseer wat je hebt gehoord of gelezen, en beschrijf wat het voor jou betekende.

Tip

“Ik kreeg de feedback dat…” of “Tijdens de code review werd opgemerkt dat…” zijn goede startszinnen.

Gebruik de juiste toon

De toon is professioneel maar niet overdreven formeel. Je schrijft voor je eigen portfolio, dus het mag persoonlijk zijn. Vermijd klakkeloos kopiëren van commentaar uit GitHub of notities van de docent. Vertaal het naar jouw eigen reflectie.

Wees concreet

Vage beschrijvingen zoals “de feedback was positief” of “ik moet beter worden” zeggen weinig. Benoem specifék wat de feedback inhield en welke concrete actie je hebt ondernomen of gaat ondernemen.

Code review: voorbeelden van verwoording

Hieronder zie je voorbeelden van hoe je ontvangen feedback uit een code review omzet naar een goede Portflow-vermelding.

Ontvangen feedback (ruwe notitie)	Zo zet je het in Portflow
“Je variabelenamen zijn onduidelijk, zoals ‘x’en ‘temp’.”	Ik kreeg de feedback dat mijn variabelenamen te generiek waren (zoals ‘x’ en ‘temp’), waardoor de code moeilijk leesbaar is voor anderen. Ik heb alle variabelen hernoemd naar beschrijvende namen en wil dit voortaan direct meenemen bij het schrijven van code.
“Je hebt geen foutafhandeling ingebouwd in de API-call.”	Tijdens de code review werd opgemerkt dat ik vergeten was foutafhandeling toe te voegen aan mijn API-aanroep. Dit kan leiden tot crashes bij een foutief antwoord. Ik heb een try-catch blok toegevoegd en begrijp nu beter waarom robuuste foutafhandeling essentieel is.
“Goed dat je comments hebt toegevoegd, maar ze zijn soms overbodig.”	Mijn reviewer gaf aan dat ik comments toevoeg op plaatsen waar de code al duidelijk voor zichzelf spreekt. Ik heb geleerd wanneer een comment wél toegevoegde waarde heeft: namelijk bij complexe logica of niet-voor-de-hand-liggende ontwerpkeuzes.

Sprint review: voorbeelden van verwoording

Bij een sprint review ontvang je feedback op het opgeleverde product of de gemaakte keuzes. Hieronder vind je voorbeelden van hoe je dit in Portflow verwoordt.

Ontvangen feedback (sprint review)	Zo zet je het in Portflow
“De demo werkte niet stabiel, je moest hem opnieuw opstarten.”	Tijdens de sprint review liep onze demo vast en moesten we opnieuw opstarten. Dit was een pijnlijk moment maar ook een waardevolle les: voortaan testen we de demo de avond van tevoren op de presentatieomgeving.
“Jullie user story was te breed, er zaten eigenlijk drie stories in.”	We kregen de feedback dat onze user story meerdere losse functionaliteiten bevatte. Door de breedte van de story was het moeilijk in één sprint af te ronden. In de volgende sprint splitsen we stories op tot elk één duidelijk doel heeft.
“Goede presentatie, maar de stakeholder snapte de technische uitleg niet.”	De opdrachtgever had moeite met onze technische toelichting. Ik realiseer me dat ik mijn taalgebruik moet aanpassen aan de doelgroep. Bij de volgende sprint review gebruik ik meer visuele voorbeelden en minder jargon.