From Mageia wiki
Jump to: navigation, search


Drakconf multiflag.png
 Other languages
Deutsch ; English ; Français ; Nederlands ; Português (Portugal) ; Türkçe ; português brasileiro ;


In het kort:
Deze pagina zal u helpen te begrijpen wat bugs (fouten) zijn, wanneer en hoe u ze gerapporteert en waar u op moet letten. Effectieve bugrapporten hebben de grootste kans om te worden opgelost. In onderstaande richtlijnen wordt uitgelegd hoe u dergelijke rapporten schrijft. Omdat 'bug' inmiddels een ingeburgerd woord is in het Nederlands, hanteren wij in dit artikel de naam bug.
Waarschuwing!
De taal die bij het melden van bugs wordt gebruikt is Engels, dus rapporteer alstublieft geen bugs in andere talen. Vraag gerust via de IRC-kanalen of forums als u iemand nodig hebt die u hierbij kan helpen.

Definitie

Wat zijn bugs precies? Een bug is de algemene term die wordt gebruikt om een fout, gebrek, vergissing, mislukking of fout in een computerprogramma of -systeem te beschrijven. Een bug levert een onjuist of onverwacht resultaat op, of zorgt ervoor dat het programma zich op onbedoelde wijze gedraagt. Maar een bug beperkt zich niet tot software; bugs kunnen overal voorkomen, in software, in hardware, bij de personen die deze onderhouden, zelfs in iemands eten (grapje). Alles kan worden gemeld als bug, dus als er een reproduceerbaar probleem is, of het nu gaat om documentatie, vertaling, artwork, de websites of de infrastructuur, misschien zelfs bij Mageia.Org zelf, een van zijn bijdragers of bij de organisatie van teams, of iets dergelijks. Verzoeken om nieuwe pakketten zijn ook bugs, om maar een voorbeeld te noemen.

Principes

  • Wees exact.
  • Wees duidelijk: leg het uit zodat anderen de bug duidelijk kunnen begrijpen.
  • Eén bug per rapport.
  • Reproduceer de bug - Als de bug die u wilt melden niet kan worden gereproduceerd op grond van uw beschrijving (op een andere computer of in een nieuwe Mageia-installatie), is de kans dat deze wordt opgelost veel kleiner. Ontwikkelaars moeten bugs kunnen reproduceren om ze te kunnen repareren.
    • Het is altijd een goed idee om op forums of op een van de mailinglijsten te vragen of iemand het betreffende probleem kan reproduceren of of iemand de bug ook ziet.
  • Probeer gerelateerde bugrapporten te zoeken voor de software waarvoor u een bug rapporteert, bijvoorbeeld voor KDE op https://bugs.kde.org/ of voor systemd op https://bugs.freedesktop.org
    Zorg er ook voor dat u eenvoudigweg naar het probleem zoekt via Google of iets dergelijks om te verifiëren of dit niet al bekend is als probleem.
  • Geen enkele bug is te triviaal om te melden. Kleine bugs kunnen grotere bugs verbergen.
  • Scheid duidelijk feiten van speculatie.
  • Geef aanroepen naar programma's altijd het voorvoegsel LC_ALL=C mee, zodat foutmeldingen of andere uitvoer in het Engels wordt weergegeven, bijvoorbeeld
    Voer niet urpmi pakketnaam uit, maar LC_ALL=C urpmi pakketnaam
    • Sommige programma's starten niet in het Engels als u LC_ALL=C gebruikt. Probeer in dat geval LC_ALL=en_US.UTF-8 of LANGUAGE=C

Voorwaarden

  • Zorg ervoor dat u een ondersteunde Mageia-versie gebruikt die volledig is bijgewerkt.
  • Ga naar https://bugs.mageia.org en zoek in Bugzilla om te zien of uw bug al is gerapporteerd.
    • U kunt gebruik maken van de snelzoekfunctie, door enkele relevante termen in te voeren.
    • Als u de letters ALL als eerste term in uw zoekreeks plaatst, worden alle relevante bugrapporten getoond, inclusief eventuele opgeloste bugs.
    • Als "uw" bug er al is, kunt u een reactie achterlaten op het bestaande bugrapport, zodat u de bug kunt bevestigen. Als u niet zeker weet of het dezelfde bug is, vraag dan om hulp op IRC of in de Mageia-forums [1].

Een nieuwe bug melden

Als u de bug in een recentere uitgave hebt gereproduceerd en niemand anders deze lijkt te hebben gerapporteerd, doe dan het volgende:


  1. Meld u aan met uw account (u moet er eerst een aanmaken, controleer FAQ over Mageia.org-gebruikersaccounts).
  2. Klik op "File a Bug" (als u dezelfde bug nog niet eerder hebt gevonden met het zoekveld).
  3. Kies "Enter a new bug". U kunt ofwel het "begeleide formulier"(guided form) gebruiken [2], danwel (als u dit al eerder heeft gedaan) het standaardformulier [3]
  4. Selecteer het product waarin u de bug heeft gevonden (alleen beschikbaar via het expertformulier). In de begeleide vorm staat "Mageia" vooraf geselecteerd. Om bugs op Mageia-websites of -infrastructuur (zoals Mageia's Bugzilla of het buildsysteem) te melden, gebruikt u het standaardformulier (zie hierboven).
  5. Voer de bron-RPM (Source RPM)[1] van het pakket in.
  6. Vul het formulier in. Hieronder staat wat hulp bij het begrijpen van de veldnamen:

Component: In welk subgedeelte van de software komt de bug voor? Dit veld is verplicht. Klik op het woord "Component" om een beschrijving van elk onderdeel te zien. Als geen enkele geschikt lijkt, selecteert u RPM-pakketten.

Version: In welke ondersteunde versie van de distributie zit de bug? Mageia-uitgaven 1-7 worden niet langer ondersteund, Mageia 9 is (op het moment van dit schrijven) de huidige ondersteunde stabiele versie, cauldron is de ontwikkelingsversie.
Als u weet dat de bug in twee of meer versies van Mageia voorkomt, stelt u deze in op de hoogste versie en voegt u de lagere versie(s) toe aan het 'Whiteboard'. Cauldron is hoger dan "9" en zodra Mageia 10 uitkomt, ook hoger dan "10". Dus totdat Mageia 10 wordt uitgebracht, zou dit voor een bug die voor alle versies geldt het volgende betekenen:

  • Stel de versie in op Cauldron
  • Zet MGA9TOO op het Whiteboard

Maar nadat Mageia 10 is uitgebracht:

  • Stel de versie in op Cauldron
  • Zet MGA9TOO, MGA10TOO op het Whiteboard

Hardware Platform: Op welke architectuur zit de bug? i586 betekent 32bit, x86_64 betekent 64bit, arm betekent ARM-architectuur en 'all' betekent dat het probleem zich op alle architecturen voordoet. Dit laatste is het meest voorkomende geval.


Source RPM (Bron-RPM): Hier kunt u precies identificeren welk RPM-pakket bij dit bugrapport betrokken is. Als u bijvoorbeeld weet dat het probleem dat u ondervindt te maken heeft met het programma mysqld, voer dan het commando rpm -qif /usr/sbin/mysqld uit. Dit vertelt u de naam en versie van het RPM-pakket (dat wil zeggen MySQL-5.0.27-1mga1), evenals andere informatie. In het bijzonder zoekt u naar het veld "Source RPM" (dat wil zeggen MySQL-5.0.27-1mga1.src.rpm) - dit is de informatie die u hier moet opgeven. Als alternatief kunt u rpm -qf /usr/sbin/mysqld --qf '%{SOURCERPM}\n' gebruiken om de informatie te verkrijgen. Als u de locatie van het betreffende programma niet weet, gebruikt u rpm -qf `which mysqld` om deze informatie te verkrijgen.

URL: (optioneel) de URL die de foutmelding laat zien die u indient. Dit kan een forumpost zijn waarin het probleem oorspronkelijk werd gerapporteerd, of een upstream bugrapport, of een bugrapport voor een andere distributie die over hetzelfde probleem gaat dat u rapporteert.

Summary: (samenvatting) Hoe zou u de bug beschrijven, in ongeveer 60 of minder letters? Een goede samenvatting moet een bugrapport snel en uniek maken. Het zou het probleem moeten verklaren, niet de door u voorgestelde oplossing. Wees beschrijvend en gebruik veel trefwoorden.

  • Goed voorbeeld: crasht in Evolution tijdens het controleren op nieuwe POP-mail
  • Slecht voorbeeld: mail crashte
  • Goed voorbeeld: Als ik een dialoogvenster Bestand kopiëren annuleer, loopt Bestandsbeheer vast
  • Slecht voorbeeld: Software crasht
  • Slecht voorbeeld: Browser zou moeten werken met mijn website

Details: De details van uw probleemrapport, inclusief:

Description of the problem: Meer gedetailleerde herformulering van de samenvatting. Maak de samenvatting uitgebreider. Wees zo specifiek mogelijk over wat er mis is.

  • Slecht voorbeeld: Het lijkt erop dat ik niet kan inloggen op het systeem. Help alstublieft!
  • Goed voorbeeld: Ik kan niet inloggen op het systeem via ssh. Het logboek /var/log/messages geeft aan dat er een probleem is met de pam-module pam_ldap, maar het bestand /etc/pam.d/system-auth bevat die module niet en ik gebruik LDAP niet. Ik heb naar /etc/pam.d/sshd gekeken en het bevat die module, maar ik weet niet zeker hoe het daar terecht is gekomen, tenzij het te wijten was aan het pittige super-ldap-mojo-pakket dat ik gisteren heb geïnstalleerd.

Version-Release number of selected component (versienummer van de component indien van toepassing):

openldap-2.3.34-5mga1, pam-0.99.7.1-2mga1

How reproducible: (hoe reproduceerbaar)

Elke keer als ik probeer in te loggen.

Steps to Reproduce: Beschrijf korte, eenvoudig te volgen stappen die de bug activeren. Voeg eventuele speciale installatiestappen toe:

  1. ssh-gebruiker@host
  2. zie de afwijzing


Voor bugs die leiden tot een crash: Kijk eens naar Debugging software crashes om te leren hoe u de vereiste foutopsporingsinformatie (backtraces) kunt produceren en verstrekken in het geval dat software crasht of een segmentatiefout veroorzaakt (segfault)


  • Voeg een bijlage toe als dit kan helpen (niet al uw logboeken, alleen het logboek van uw probleem).

U kunt in de Triage Guide kijken om te zien of er meer specifieke informatie vereist is voor uw bugrapport, wat het werk van het triageteam vermindert.

  • Voer het e-mailadres van de pakketbeheerder[2] in Assign To in als u het weet (of laat het triageteam dit toevoegen).


Controleer uw rapport nogmaals op fouten en weglatingen en druk vervolgens op 'Commit'. Uw bugrapport bevindt zich nu in de Bugzilla-database.

[1], [2]: rpm -qi package geeft u veel informatie over een pakket.

Delen van deze pagina zijn afkomstig van een pagina van Bugzilla, die niet meer bestaat, Actuele informatie vindt u op de website van Bugzilla: https://bugzilla.readthedocs.io/en/5.0.4/using/index.html

Een pakketaanvraag indienen

Dit is vergelijkbaar met het indienen van een bug, maar er zijn enkele verschillen in de benodigde informatie.

  • Ga naar https://bugs.mageia.org
  • Voer een snelle zoekopdracht uit naar "ALL <pakketnaam>", vervang "<pakketnaam>" uiteraard door de echte naam van het pakket.
    • Als iemand al een verzoek heeft ingediend, voeg dan de opmerking toe dat u het pakket ook in Mageia wilt zien.
    • Als het verzoek werd gesloten als WONTFIX, kwam dat waarschijnlijk omdat het project upstream dood is. In dat geval zal er doorgaans een alternatief Mageia-pakket worden genoemd.
    • Als u niets heeft gevonden met de snelzoekopdracht, gaat u verder met de volgende stap:
  • kies File a bug (Een four melden)
  • kies product Mageia
  • (Component:) kies "New RPM package request"
  • (Version:) kies "Cauldron"
  • (Hardwareplatform:) kies "All"
  • (Source RPM:) voeg hier geen link toe. Als u weet welke naam de SRPM moet krijgen, voeg dan die naam toe. Laat het leeg als u het niet weet.
  • (URL:http://) geef de upstream-link naar het pakket
  • (Summary) noem "de pakketnaam", en "een korte samenvatting van het doel van het programma"

Voorbeeld: vagrant, a tool to build virtualized environments with VirtualBox

  • Gebruik bij de pakketnamen alleen kleine letters (onderkast), dit maakt het makkelijker eens in de zeveel tijd te controleren of we ze al hebben.
  • (Details) vertel waarom u de software geweldig vindt en waarvoor u deze nodig heeft.
  • (Severity) (ernst van het probleem): stel dit veld in op "Enhancement" (Verbetering).
  • Dien het rapport in.

Ga naar het Bugsquad-portaal

Retrieved from "https://wiki.mageia.org/mw-en/index.php?title=Hoe_meld_ik_correct_een_fout_(bug)-nl&oldid=63548"