Hoe lever je code aan voor uitleg of beoordeling?
Beperk de reikwijdte zodat observaties in code te onderscheiden zijn van uitvoeringsresultaten.
Beperk het codegedeelte
Geef eerst de te beoordelen functie of passage met de taal, aanroepwijze en het verwachte gedrag. Hangt het probleem af van configuratie, invoerformaat of andere functies, voeg dan de minimale nodige context toe. Geef aan of je de programmastroom, randvoorwaarden of mogelijke fouten wilt begrijpen, zodat het antwoord geen algemene controlelijst voor het hele project wordt.
Geef concrete beoordelingsdoelen
Schrijf bijvoorbeeld: ‘Leg uit hoe deze functie lege invoer verwerkt en welke randgevallen getest moeten worden’. Vraag bij wijzigingsvoorstellen ook naar redenen en verwachte gevolgen. Controleer inspringing en bestandsnamen wanneer je code plakt of als bijlage toevoegt. Neem niet voor het gemak echte sleutels of geheimen in het materiaal op.
- Geef relevante code, programmeertaal en verwachte resultaten.
- Beschrijf het werkelijke gedrag of de belangrijkste zorgen.
- Vraag om bevindingen, adviezen en controlemethoden afzonderlijk te vermelden.
Controleer welke beoordelingsstappen voltooid zijn
Alleen code lezen levert statische analyse op en betekent niet dat tests zijn uitgevoerd. Zegt het antwoord dat het programma draaide, controleer dan de bijbehorende tooluitvoer. Is de omgeving niet beschikbaar, vraag dan om een lijst van onbevestigde onderdelen. Controleer wijzigingen vóór gebruik nog steeds in een geschikte omgeving, met extra aandacht voor zowel normale invoer als foutafhandeling.