Handleiding: Gebruik van de GitHub Issue Tracker voor het Vlaams Biodiversiteitsportaal (BVP)

Met de GitHub Issue Tracker kunt u eenvoudig problemen, suggesties en verbeterpunten rapporteren. Hieronder vindt u een stapsgewijze uitleg.

1. Toegang tot de Issue Tracker

  1. Log in met uw GitHub-account. Heeft u geen account? Registreer op GitHub en volg de instructies.
  2. Open de issue tracker via deze link: VBP GitHub Issue Tracker.
  3. Maak direct een nieuw issue aan door op deze knop te drukken:

image1

2. Bestaande Issues Doorzoeken

  1. Gebruik de zoekbalk bovenaan om te controleren of uw issue al is gerapporteerd.
  2. Filter issues op basis van status (bijv. open of closed) of labels (bijvoorbeeld bug of spatial).
  3. Klik op een issue om meer details te bekijken en eventuele updates te volgen.

image2

3. Een Nieuw Issue Aanmaken

  1. Klik op de groene knop "New Issue" rechtsboven.
  2. Titel: Geef een duidelijke titel die het probleem of de suggestie kort samenvat.
    • Voorbeeld: *"Zoekfunctie toont geen resultaten bij specifieke filters"*
  3. Beschrijving: Geef een gedetailleerde omschrijving. Voeg indien mogelijk de volgende informatie toe:
    • Wat ging er mis?
    • Voeg ook de url steeds toe; te vinden in de balk van je browser (zoals: https://natuurdata.dev.inbo.be/?lang=nl)
    • Welke stappen hebt u ondernomen om het probleem te reproduceren?
    • Eventuele screenshots of foutmeldingen (upload via drag-and-drop).
  4. Labels: Selecteer een passend label (bijv. bug, enhancement, translation).
    • Dit helpt ontwikkelaars om issues efficiënter te categoriseren.
  5. Klik op "Submit new issue" om uw melding op te slaan.

4. Reageren op een Issue

  1. Open een bestaand issue.
  2. Voeg een reactie toe in het tekstveld onderaan als u aanvullende informatie, verduidelijkingen of ondersteunende gegevens kunt leveren.
  3. Klik op "Comment" om uw reactie op te slaan.

5. Tips voor Effectief Gebruik

  • Wees specifiek: Beschrijf het probleem of de suggestie zo gedetailleerd mogelijk.
  • Gebruik visuele hulp: Voeg indien mogelijk screenshots of video's toe om uw melding te verduidelijken.
  • Blijf beleefd en constructief: Dit bevordert een efficiënte en prettige samenwerking.

6. Hulp en Ondersteuning

Heeft u vragen over het gebruik van de issue tracker? Neem contact op met het BVP-team via support@vlaamsbiodiversiteit.be.

Dank u voor uw bijdrage aan de verbetering van het Vlaams Biodiversiteitsportaal!