Hoe een softwarefout naar Fedora te versturen

Een bug of softwarefout is een fout, vergissing, mislukking of fout in een programma waardoor het ongewenste of onjuiste resultaten oplevert. Een bug verhindert dat een programma/applicatie/software functioneert zoals bedoeld.

Zoals de meeste, zo niet alle Linux-distributies, biedt Fedora een manier voor gebruikers om een bugrapport in te dienen. Houd er rekening mee dat het indienen van bugs niet beperkt is tot softwareontwikkelaars; iedereen (inclusief gewone gebruikers) wordt aangemoedigd om bugs die ze tegenkomen te rapporteren. Zodra een bug is opgelost, bekijkt de pakketbeheerder het bugrapport en beslist hoe ermee om te gaan.

Belangrijk: een bug hoeft niet noodzakelijkerwijs een softwarecrash te zijn. Met betrekking tot de bovenstaande definitie van een bug: elk ongewenst of onverwacht gedrag dat in een applicatie wordt opgemerkt, moet als een bug worden ingediend.

In dit artikel zullen we de verschillende stappen uitleggen van het indienen van een software- of applicatiefoutenrapport in Fedora.

Voordat je een bug in Fedora indient

Voordat u een bug meldt, moet u ervoor zorgen dat u de nieuwste versie van een software gebruikt. Als dit niet het geval is, download en installeer het dan. Normaal gesproken worden de nieuwste softwareversies geleverd met bugfixes, verbeteringen en meer. Een bug die u wilt melden, is mogelijk opgelost in de nieuwste versie van de software.

Om alle software die op je Fedora systeem geïnstalleerd is bij te werken naar de nieuwste beschikbare versies, voer je regelmatig het volgende dnf commando uit (met root rechten) om je systeem te controleren en bij te werken.

sudo dnf update --refresh

Als de nieuwste versie van de software de bug nog steeds bevat, kunt u controleren of de bug is ingediend of niet. Je kunt alle ingediende bugs voor een Fedora pakket controleren met behulp van de URL:

https://apps.fedoraproject.org/packages/<package-name>/bugs/

U komt dan direct op een pagina met een lijst met alle gerapporteerde bugs voor het betreffende pakket, in de indeling (bug, status, beschrijving en release). Deze pagina bevat ook een link voor het melden van een nieuwe bug (Een nieuwe bug indienen) en geeft het totale aantal openstaande en blokkerende bugs weer. Bijvoorbeeld:

https://apps.fedoraproject.org/packages/dnf/bugs/

Om details van een bug te bekijken (bijvoorbeeld DNF Bug 1032541), klikt u erop. Als er al een bugrapport is ingediend waarin het probleem wordt beschreven, kunt u eventuele aanvullende informatie aan het rapport toevoegen.

Om updates over het rapport te ontvangen, moet u uzelf “CC” (carbon-copy) naar het rapport sturen. Vink de optie “Voeg mij toe aan CC-lijst” aan en klik op de knop “Wijzigingen opslaan”.

Zodra u ontdekt dat de bug niet is gemeld, kunt u deze indienen zoals uitgelegd in de volgende sectie.

Een bugrapport indienen in Fedora

Om een bug te melden, klik je op de knop Een nieuwe bug indienen en selecteer je “tegen Fedora” of “tegen EPEL” in het vervolgkeuzemenu .

U wordt doorgestuurd naar een nieuwe bugrapportsjabloon op de bugtracker, zoals weergegeven in de volgende afbeelding. Houd er rekening mee dat u, om toegang te krijgen tot de bugrapportsjabloon, een Red Hat Bugzilla-account moet hebben en ingelogd moet zijn, anders kunt u een nieuw account aanmaken.

Laten we kort uitleggen welke velden moeten worden ingesteld:

Component: gebruikt om de naam van het pakket op te geven.
Versie: wordt gebruikt om de versie van Fedora in te stellen waarop je de bug hebt waargenomen. U kunt ook de ernst, de hardware en het besturingssysteem opgeven.
Samenvatting: gebruik dit om een nuttige korte samenvatting van het probleem te geven.
Beschrijving: voeg meer gedetailleerde informatie over het probleem toe met behulp van de meegeleverde sjabloon (hieronder uitgelegd).
Bijlage: gebruik dit om bestanden bij te voegen die meer informatie geven over het probleem (bestanden kunnen schermafbeeldingen, logbestanden, schermopnamen enz. bevatten).

Versie-releasenummer van geselecteerde component (indien van toepassing):

Het versie-releasenummer van het pakket moet hier worden opgegeven. U kunt het rpm-commando gebruiken om het versienummer van het pakket op te halen (DNF-versie 4.0.4 in dit voorbeeld):

rpm -q dnf

Hoe reproduceerbaar:

Geef op hoe vaak het probleem optreedt. Aanbevolen antwoorden zijn onder meer:

Altijd: gebruik dit als u het probleem zo nu en dan tegenkomt.
Soms: voer dit in als u het probleem soms waarneemt.
Slechts één keer: voer dit in als u het probleem één keer heeft opgemerkt.

Stappen om te reproduceren:

In het laatste gedeelte van de probleembeschrijving kunt u informatie verstrekken waarmee andere gebruikers de bug kunnen verifiëren, en zij kunnen de ontwikkelaars ook informeren over welke specifieke stappen het probleem veroorzaken.

Werkelijke resultaten: specificeer wat u waarneemt wanneer het probleem zich voordoet.
Verwachte resultaten: dit veld wordt gebruikt om in te voeren wat u verwacht dat er zal gebeuren als de software zich correct gedraagt.
Aanvullende informatie: voeg hier extra informatie toe die nuttig kan zijn voor de beheerder.

Nadat u een bug heeft gerapporteerd, is het volgende dat u moet letten op eventuele updates hierover. Normaal gesproken wordt er per e-mail een kennisgeving van nieuwe opmerkingen over het rapport verzonden naar iedereen die deel uitmaakt van het bugrapport (d.w.z. de verslaggever, de beheerder en andere gebruikers).

Als de bug opgelost is, brengt de onderhouder een verbeterde versie van de software uit. Bodhi (een websysteem dat het proces van het publiceren van updates voor een op Fedora gebaseerde softwaredistributie vergemakkelijkt) zal een commentaar aan het rapport toevoegen, nadat een verbeterde versie van de software is uitgebracht.

Last but not least kunt u de beheerder helpen door te bevestigen of de verbeterde versie beter werkt in de Bodhi. Wanneer de verbeterde release van de software het QA-proces (Quality Assurance) heeft doorstaan, wordt de bug automatisch gesloten.

Dat is alles! In dit artikel hebben we de verschillende stappen uitgelegd van het indienen van een nieuw bugrapport in Fedora. Als u vragen, opmerkingen of extra informatie heeft, kunt u het onderstaande feedbackformulier gebruiken.