[tutorial] Een bug of suggestie melden

[floris v]

Zie ook de uitgebreide beschrijving met plaatjes op nl.openoffice.org.

Waarom een bug melden of een suggestie doen?

* OOo bevalt je, wil je het verbeteren? Help de ontwikkelaars door hen te wijzen op de zwakke plekken die je zijn opgevallen.
* Dezelfde procedure wordt gebruikt om te vragen om nieuwe functies.

1. Overtuig je ervan dat er sprake is van een bug

* Je dient de fout in de nieuwste versie te hebben gezien omdat een bug in een oude versie inmiddels kan zijn verholpen. Merk op dat de versienummers #.#.1 alleen voor bug fixes dienen, upgrade dus als zo'n versie beschikbaar is.
* Door hier een onderwerp over de bug te beginnen kun je vaststellen of de issue gekoppeld is aan je systeem (of een specifiek bestand). Bovendien krijg je veel meer informatie: soms is een bug specifiek voor een bepaald OS of een distributie (voor Linux).
* Probeer als je een Linux-distributie hebt eerst vast te stellen of de bug niet afkomstig is van je distributie.

2. Ga na of de bug of suggestie nog niet eerder is gemeld
Zie voor LibreOffice LibreOffice: LibreOffice
Ga naar de zoekpagina: Apache OpenOffice.org (Engels en pittig)
* Selecteer in het veld Component Word Processor voor Writer, spreadsheet voor Calc, Chart voor charts in Calc, Presentation voor Impress, Formula editor voor Math, Drawing voor Draw, Database access voor Base, framework voor een probleem met OOo in zijn geheel, ...
* Typ in het veld Summary, onderaan, trefwoorden die betrekking hebben op de issue.
* Klik op Submit.

Het moeilijkste is om te raden welke zoekwoorden andere gebruikers zouden kunnen hebben gebruikt om hun issue te melden. Probeer eerst een paar trefwoorden tegelijk en als dat geen treffers oplevert, verwijder je ze een voor een om de query uit te breiden.

3. We gaan de bug melden
Eerst moet je je aanmelden bij het Issue Tracker (IT)-systeem: http://www.openoffice.org/servlets/Join. Omdat die een andere gebruikersdatabase heeft dan het forum, moet je je daarvoor apart registreren. Als je forumgebruikersnaam niet is gebruikt door iemand anders in de Issue Tracker, kun je dezelfde gebruikersnaam en wachtwoord gebruiken.
Controleer je e-mailaccount en bevestig de registratie. Log dan in bij het IT en klik op New (onder de kop).
Selecteer de meest geschikte component.
Geef dan zoveel mogelijk details.

* Het soort issue wordt automatisch ingesteld op Defect, verander het zo nodig in Enhancement of in Feature voor een nieuwe functie die je wil laten opnemen.
* Zet in het veld Summary een zo beknopt en precies mogelijke samenvatting (het is de titel van de issue die zal naast de vindplaats in query's komt te staan).
* Als hier of op het Engelstalige forum een onderwerp met interessante informatie over de issue staat, kun je de link daarvan in het veld URL zetten.
* Merk op op dat je bestanden kunt uploaden om de issue te verduidelijken (document, screenshot, ...)
Als je klaar bent, klik dan op Submit Issue.


4. Stem ervoor!
Elke account kan een of twee stemmen uitbrengen voor issues. Je kunt 5 stemmen uitbrengen per component en 1 of 2 stemmen per issue.
Klik op de link om naar de stemming-pagina voor je issue te gaan, vul het overeenkomstige veld in en klik op de knop Submit onderaan de pagina om je stem te bevestigen.
Merk op dat wanneer een issue is opgelost, je je stemmen ervoor zelf moet verwidjeren: ga naar de pagina Mijn stemmen, zet 0 in plaats van het aantal en klik op Submit. Opgeloste issues zijn aangegeven met doorgestreepte karakters.

5. Haal andere mensen over om voor de issue te stemmen!]
Je hebt hier een onderwerp over de issue? Post de link naar js issue daar, zodat andere gebruikers snel naar de IT kunnen gaan om hun stem uit te brengen als ze geïnteresseerd zijn.
Gebruik de BBCode URL voor dat: [ url =address_to_bug_report] Issue # - Overzicht [/ url] (spaties toegevoegd in tags om de automatische herkenning te omzeilen).
Maak reclame voor je issue: zet de tag '[Issue]' aan het begin van de titel van je eerste bericht in je onderwerp.

6. Extra links]
- QA-proces: http://qa.openoffice.org/issue_handling ... ssion.html
- Globale OOo-pagina's over het helpen: http://qa.openoffice.org/helping.html