IBA Verklaart Bugweb

Ondanks alle inspanningen van de technische commissies zijn er weleens problemen met bijvoorbeeld de website of een \text{\LaTeX}-package. Om deze problemen en de oplossingen op een gestructureerde manier bij te houden is Bugweb in het leven geroepen.

In principe mag iedereen die is ingelogd op de website nieuwe bugs invoeren en reeds bestaande bugs aanpassen. Bij aanmaken of aanpassen wordt automatisch een notificatie gestuurd naar de betrokken commissie. Heel fijn allemaal maar hoe moet je nou een bug invoeren waar een commissie iets aan heeft?

Bugweb
Voorpagina Bugweb

Allereerst is het belangrijk om je probleem zo duidelijk mogelijk samen te vatten in het onderwerp van de bug. Verder is het goed om een zo specifiek mogelijke categorie aan de bug te koppelen. Dus kies bijvoorbeeld “I Owe You” in plaats van “Website”. De keuze voor de status van een bug is redelijk makkelijk: “Open” als er iets kapot is, “Feature request” als er functionaliteit ontbreekt.

Dan volgen de twee leukste onderdelen van een nieuwe bug: de prioriteit en het daadwerkelijke bugrapport. Hou bij het inschatten van de prioriteit van de bug in je achterhoofd dat “Urgent” ook echt urgent is (als in: problemen waar je iemand midden in de nacht voor wakker zou bellen) en dat problemen met prioriteit “Onbenullig” ook gewoon opgelost worden. Stap nummer laatst is dus het invullen van je bericht. Zorg dat je zo helder mogelijk omschrijft wat je probleem is en dat je foutmeldingen zorgvuldig kopieert.

Ten slotte nog een aantal tips met betrekking tot bugs voor specifieke commissies:
Sysop: Zorg dat je de naam van de machine waar het probleem is opgetreden in je bugrapport opneemt.
Webcie: Plak de URL van de pagina die kapot is in je bugrapport.
TeXniCie: Geef een minimal working example.