Bugs melden

Gebruik voor nieuwe bugs altijd het formulier op agent.dppapi.nl/bugs.

Deze handleiding sluit aan op de huidige live flow. De oude werkwijze via handmatig issues aanmaken in Flowlu is hiervoor niet meer leidend.

Voor je begint

Wat je op de pagina ziet

De bugpagina bestaat uit deze onderdelen:

• een titelveld
• een optionele categorie
• een verplicht ernstniveau
• drie verplichte tekstvelden voor probleem, verwacht gedrag en reproductie
• een optionele links-sectie
• een verplichte screenshot-sectie
• conditionele spraak- en AI-functionaliteit
• een verzendknop en daarna een successtatus met Plane-link

Invoeren: tekst of spraak

Je kunt bugs op drie manieren opbouwen:

Belangrijk:

• zie je geen microfoon, dan staat spraak voor jouw account niet aan
• screenshots moet je altijd nog handmatig toevoegen
• controleer AI-aanvulling altijd voordat je verzendt

Wat je het beste noemt tijdens een opname

Noem tijdens een volledige opname bij voorkeur meteen:

• op welke pagina of in welk scherm het probleem optreedt
• welke actie je uitvoert vlak voor de bug zichtbaar wordt
• wat er feitelijk gebeurt
• wat er volgens jou had moeten gebeuren
• of het altijd gebeurt of alleen soms
• of er een foutmelding zichtbaar is
• wat de impact is op jouw werk of op andere collega's
• welke link of bron relevant is voor het onderzoek

Zo hoeft er achteraf minder context te worden nagevraagd en wordt de bug vollediger vastgelegd.

Titel, categorie en ernst

Titel

Houd de titel kort en specifiek. Goede voorbeelden:

• Screenshot upload faalt op bugpagina
• Vacatures laden niet in TESS
• WordPress publicatie blijft hangen

Categorie

Categorie is niet verplicht. Laat je dit leeg, dan probeert het systeem de categorie automatisch te detecteren.

De live opties zijn:

• Automation
• Storage
• Distribution
• Infrastructure
• GenAI
• TESS

Ernst

Gebruik deze vuistregel:

• Kritiek bij uitval, crash, dataverlies of onbereikbaarheid
• Hoog als een kernfunctie niet werkt
• Gemiddeld als het werk hindert maar een workaround mogelijk is
• Laag bij kleine of cosmetische problemen

Beschrijf het probleem goed

De drie verplichte inhoudelijke velden zijn:

Wat gebeurt er?

Beschrijf feitelijk wat je ziet.

Wat hoort er te gebeuren?

Beschrijf het verwachte gedrag.

Stappen om te reproduceren

Beschrijf exact hoe iemand anders hetzelfde probleem opnieuw kan zien.

Werk bij voorkeur in deze volgorde:

1. wat je doet
2. wat je ziet
3. wat je verwachtte

Links toevoegen

Bij Links kun je relevante URL's toevoegen, bijvoorbeeld:

• de pagina waar het probleem optreedt
• een preview- of staginglink
• een specifieke beheerpagina
• een Plane-item of andere bron die context geeft

Je kunt meerdere links toevoegen. Houd alleen links over die echt helpen bij het onderzoeken.

Screenshots toevoegen

Screenshots zijn verplicht.

De live pagina accepteert:

• minimaal 1 screenshot
• maximaal 5 screenshots
• maximaal 10 MB per screenshot
• alleen afbeeldingsbestanden

Toevoegen kan op drie manieren:

• sleep bestanden naar het uploadvlak
• plak een screenshot met Ctrl+V
• klik op het uploadvlak en selecteer bestanden

Praktische tips:

• laat het relevante deel van het scherm zien
• neem de foutmelding mee als die zichtbaar is
• voeg de URL mee toe als die helpt om het probleem te herhalen
• gebruik liever 2 duidelijke screenshots dan 5 half-relevante

AI-suggesties

Na het invullen kan de pagina AI-suggesties tonen voor:

• categorie
• titel
• ernst
• extra context

Neem die alleen over als ze inhoudelijk kloppen.

Verzenden

Het formulier kan alleen worden verzonden als deze onderdelen aanwezig zijn:

• titel
• Wat gebeurt er?
• Wat hoort er te gebeuren?
• Stappen om te reproduceren
• minimaal 1 screenshot

Browser en besturingssysteem worden op de achtergrond automatisch meegestuurd. Die hoef je dus niet apart in te vullen.

Na het verzenden

Na een succesvolle inzending zie je:

• bevestiging dat het bugrapport is ingediend
• in welk Plane-project het item is aangemaakt
• hoeveel screenshots zijn toegevoegd
• een knop Bekijk in Plane

Korte checklist

• Ik heb eerst eenmalig ingelogd op plane.dppapi.nl
• Ik gebruik op agent.dppapi.nl/bugs mijn @depubliekepartner.nl-werkaccount
• De titel beschrijft het probleem kort en duidelijk
• Ik heb feitelijk beschreven wat er misgaat
• Ik heb opgeschreven wat er had moeten gebeuren
• Ik heb de reproductiestappen concreet gemaakt
• Ik heb minimaal 1 goede screenshot toegevoegd
• Ik heb AI-suggesties alleen overgenomen als ze echt kloppen

Referentie voor onderhoud

Onderstaande links verwijzen naar de live UI-bronnen waarop deze handleiding is gebaseerd, commit 60b437f: