Probleemrapporten voor FreeBSD schrijven

$FreeBSD: head/nl_NL.ISO8859-1/articles/problem-reports/article.xml 39768 2012-10-18 14:43:16Z rene $

$FreeBSD: head/nl_NL.ISO8859-1/articles/problem-reports/article.xml 39768 2012-10-18 14:43:16Z rene $

Bericht

Dit artikel beschrijft hoe een probleemrapport het beste geformuleerd en naar het FreeBSD Project verzonden kan worden.

Vertaald door René Ladan.


Inhoudsopgave
1. Introductie
2. Wanneer een probleemrapport te versturen
3. Voorbereidingen
4. Het probleemrapport schrijven
5. Vervolg
6. Als u problemen heeft
7. Verdere literatuur

1. Introductie

Eén van de meest frustrerende ervaringen die een gebruiker van software kan hebben is om een probleemrapport in te sturen om het vervolgens afgehandeld te zien met een korte en onbehulpzame uitleg als “geen bug” of “fout PR”. Evenzo is één van de meest frustrerende ervaringen als ontwikkelaar van software om overspoeld te worden met probleemrapporten die niet echt een probleemrapport zijn maar ondersteuningsverzoeken, of die weinig tot geen informatie bevatten over wat het probleem is en hoe het te reproduceren.

Dit document poogt te beschrijven hoe goede probleemrapporten te schrijven. Wat is een goed probleemrapport? Kort door de bocht is een goed probleemrapport een rapport dat geanalyseerd kan worden en waar snel mee kan worden omgegaan, voor de wederzijdse voldoening van zowel de gebruiker als de ontwikkelaar.

Hoewel de nadruk van dit artikel ligt op probleemrapporten voor FreeBSD, zou het meeste ook in sterke mate op andere softwareprojecten van toepassing moeten zijn.

Merk op dat dit artikel thematisch in plaats van chronologisch is ingedeeld, dus u dient het hele document te lezen alvorens een probleemrapport in te sturen, en het niet als een stapsgewijze tutorial te behandelen.