Een goede Issue beschrijving bevat de volgende onderdelen:**

• Wat is er gebeurd? - Feitelijke beschrijving van de afwijking
• Directe ondernomen acties - Eerste reactie en damage control
• Root cause analyse - Onderzoek naar onderliggende oorzaken
• Actie plan om de root cause weg te nemen - Geplande oplossingen en preventie

Samenwerken via comments

Comments toevoegen

Nieuwe comment schrijven:

1. Scroll naar beneden tot "Add your comment" sectie
2. Type je bericht in het tekstveld
3. Gebruik Markdown voor structuur (koppen, lijsten, links)
4. Klik "Submit" om comment te plaatsen

Comment best practices:

• Specifieke updates - Wat heb je gedaan, wat was het resultaat?
• Actioneerbare informatie - Concrete volgende stappen vermelden
• Tijdlijn context - Wanneer verwacht je resultaten?
• Evidence referenties - Verwijs naar geüploade bestanden

@Mentions gebruiken

Personen notificeren:

1. Type @ gevolgd door naam of initialen
2. Selecteer persoon uit dropdown lijst
3. Persoon ontvangt automatische notificatie
4. Gebruik voor escalaties, vragen, of updates

Effectieve @mentions:

@john Kun je de firewall logs checken voor periode 10-12 januari?

@maria De nieuwe procedure is klaar voor review. Zie bijgevoegd document.

@team We hebben de root cause geïdentificeerd. Zie update hieronder.

Bewijsmateriaal verzamelen

Bestanden uploaden

Documenten toevoegen:

1. Scroll naar comment sectie
2. Klik "Drop, or click to add files" of sleep bestanden naar het comment veld
3. Bestanden worden geüpload en gekoppeld aan comment
4. Link verschijnt automatisch in je comment

Hoe ziet goed bewijsmateriaal eruit?

Voor Incidenten:

• Tijdlijn documentatie - Wanneer wat ontdekt en ondernomen
• Impact assessment - Welke systemen/users getroffen
• Respons acties - Concrete stappen ondernomen
• Bewijs van herstel - Bewijs dat systemen hersteld zijn

Voor Audit findings:

• Originele finding - Exacte auditor feedback
• Gap analyse - Wat ontbreekt of faalt
• Actieplan - Hoe ga je het oplossen
• Bewijs van afronding - Bewijs dat issue opgelost is

Voor Control gaps:

• Huidige status - Hoe werkt het nu
• Verwachte status - Wat moet geïmplementeerd
• Bewijs van implementatie - Nieuwe configuraties/procedures
• Testresultaten - Validatie dat control werkt

Afronden, reviewen, en heropenen

Issues sluiten

Direct sluiten

1. Selecteer het drie-puntjes menu rechts bovenin het Issue details panel
2. Selecteer "Close issue" uit het dropdown menu

Met een opmerking sluiten

1. Schrijf de laatste opmerking als een nieuwe comment
2. Selecteer "Submit and Close" in plaats van alleen "Submit"

:::tip

Na het sluiten van een Issue is deze alleen nog zichtbaar onder 'closed' Issues, en niet meer in andere overzichten.

Zorg er dus voor dat een Issue helemaal is opgelost voor je hem sluit of maak een nieuw Issue aan voor het volgen van eventuele openstaande (lange-termijn) acties.

Na het reviewen van een taak veranderen de "Review Issue" en "Submit and Review" knoppen naar respectievelijk "Undo review" en "Submit and Undo review". Hiermee kan de review ongedaan gemaakt worden.

Sluit taken tijdig: Sluit issues af zodra ze werkelijk opgelost zijn. Uitstellen hiervan leidt tot administrative overhead en verlies van context informatie.