QA/BugReport
TDF LibreOffice Document Liberation Project Blogs gemeenschap Weblate Nextcloud Redmine Ask LibreOffice Doneren
Mooi dat u ons heeft gevonden. U staat op het punt om een belangrijke bijdrage aan LibreOffice te leveren. Een goede omschrijving van een bug is heel nuttig voor onze ontwikkelaars. Hieronder vind u enkele aanwijzingen om dat eenvoudiger te maken.
Niet alle problemen gaan naar Bugzilla
Alle honden mogen naar de hemel gaan, maar sommige problemen moeten buiten Bugzilla gevolgd worden. Deze bevatten:
Locatie of class van het probleem | Waar moet u het melden |
---|---|
LibreOffice-extensies | Bij de maker van de extensie |
TDF/LibreOffice infrastructuur (websites, mailinglijsten, enz.) | Redmine |
LibreOffice compileren | Developer mailinglijst |
LibreOffice Unit-tests | Developer mailinglijst |
Woorden die ontbreken in woordenboeken | Naar degene die het woordenboek beheert of de repository |
Vertaalfouten | Het rapporteren in Bugzilla is toegestaan, maar het is efficiënter om ze als suggesties in Weblate toe te voegen (hiervoor hoeft u zich niet te registreren) |
Voordat u een probleem meldt
Verzeker u ervan dat het echt een bug is. Meestal is een bug iets dat ervoor zorgt dat de software werkt op een manier die een normale gebruiker niet wil. Zoals dat de software niet doet wat u wil dat hij doet, dat hij iets doet waar u niet om gevraagd hebt of dat het programma bij normaal gebruik vastloopt of zomaar stopt. Een bug kan er ook voor zorgen dat de software er veel langer over doet en veel meer hulpbronnen gebruikt worden dan nodig is.
Overweeg om eens te kijken naar Eerste stappen die moeten worden genomen voordat u een bug indient, in het bijzonder voor bugs met lettertypen, afbeeldingen, diavoorstellingen en berekeningen.
Als u redelijk vertrouwd bent met LibreOffice en op iets stuit dat op een bug lijkt maar dat ook iets kan zijn dat u niet begrijpt, kunt u een vraag stellen op LibreOffice gebruikers mailinglijst (Engelstalig), Nederlandse of op Ask LibreOffice. Overweeg om de gebruikersdocumentatie te lezen en de applicatie voldoende te gebruiken om vertrouwd te raken met wat deze normaal doet.
Maar stel dat u iets heeft gevonden dat echt op een bug lijkt. Doe dan vervolgens:
- Maak aantekeningen zodat u niet vergeet wat er gebeurde rond de tijd dat de bug verscheen. Wat was u aan het doen, wat verwachtte u dat er zou gebeuren, en wat gebeurde er echt? Hoe wist u dat er iets fout zat? Kunt u de bug reproduceren?
- Indien mogelijk, controleer of er soortgelijke bestaande bugrapporten zijn (Probeer in ieder geval even of u er een kunt vinden):
- Ga naar Components en kies de component of subcomponent die van toepassing is.
- Als u een component hebt gekozen, kies dan de juiste subcomponent, of Extended Help als u de subcomponent niet op die pagina ziet.
- Als u Extended Help hebt gekozen, kies dan de juiste subcomponent, of de [1] onderaan de lijst als u de juiste subcomponent niet kan vinden of niet weet wat de juiste subcomponent is.
- U krijgt een lijst bugrapporten te zien die bij die subcomponent horen. Kies onderaan de pagina "Edit Search'. Daar kunt u dan de zoekopdracht aanpassen.
- Als u een bugrapport vindt dat met uw probleem te maken heeft, kunt u daar een opmerking bij plaatsen. Als u geen bugrapport vindt dat betrekking heeft op uw probleem, kunt u een bugrapport indienen.
- Als de bug alleen optreedt op Ubuntu of te maken heeft met Afdrukken, ga dan naar hier.
- Volg na dat alles, als er kennelijk geen bestaand ticket over dit probleem is, de volgende instructies op.
Een probleem melden
Ga naar Bugzilla.
Meld u aan

Als u wordt gevraagd om in te loggen, log dan in met uw Bugzilla-account.
Als u geen Bugzilla-account heeft, maak er dan een aan.
Component
Kies in Component de component.
Als u er niet zeker van bent met welke component uw probleem te maken heeft, kies dan het LibreOffice
pseudo-component. Later beoordeelt iemand het bugrapport, en die kiest dan een preciezere component.
Als het om een ernstig probleem gaat (niet-werkende delen, regressie enz.), en u bent een ervaren gebruiker die het ontwikkellaarsteam kent, kunt u het bugrapport toewijzen aan een van de ontwikkelaars op de pagina FindTheExpert.
Details
Als er een sectie Subcomponent is, kies dan de subcomponent.
Als u juiste subcomponent niet kent, ga dan naar Components. Klik op die pagina op de juiste component. Lees de beschrijvingen van alle subcomponenten van die component op die pagina. Als u geen geschikte subcomponent vindt, klik dan op Extended help en lees de beschrijvingen van de subcomponenten op die pagina.
Kies de versie van de applicatie waarin de bug verscheen. U ziet welke versie van LibreOffice u gebruikt met
▸ .Kies in Operating system of OS het besturingssysteem van de computer waarop u met de bug te maken kreeg.
Als er een sectie Hardware is, vul die dan in.
Als er een sectie Severity (ernst) is en u dient een functieverzoek in, selecteer enhancement. Negeer het anders, tenzij u een ervaren gebruiker bent. De bug wordt niet sneller gerepareerd als u Blocker (stopper) kiest. Raadpleeg dit schema voor de definities van de items in de sectie Severity.
U kunt de sectie latest known-working version (laatst bekende werkende versie) negeren.
Subject
Controleer in de tabel possibly related Bugs (mogelijk soortgelijke bugs) op de pagina voor bugmeldingen en verder op Tabel met duplicaten of het probleem echt nog niet gemeld is.
In de sectie Subject (onderwerp, ook bekend als Summary, samenvatting):
- Geen informatie opnemen die al bekend is uit de fields.
- Wel de namen van de subcomponenten uit Components opnemen.
- Schrijf de subcomponenten met hoofdletters.
- Als de subcomponent verwart kan worden met een deel van een woord (bijv.: UI is deel van het woord quit), zet de subcomponent dan tussen vierkante haakjes.
- Gebruik niet meer dan twee subcomponenten.
- Neem de subcomponenten over uit de lijst, u kunt ze integreren in de onderwerpregel. Bijvoorbeeld: “WIKIHELP [UI] not available in all languages”.
- Geef het probleem beknopt weer.
- Slechte tekst: “File is broken”
- Betere tekst: “Menu File > Save as not available (greyed out)”
- Gebruik geen afkortingen voor woorden als “doesn’t” en “isn’t”, dan is zoeken later gemakkelijker. Gebruik dus: “does not” en “is not”.
- Als LibreOffice crashes of niet meer reageert (“hangs”), voeg dan het woord CRASH toe in de samenvatting, zodat er later op gezocht kan worden.
Description and attachments
In de Long Description of Description sectie kunt u een uitgebreidere beschrijving geven van het probleem:
- geef de stappen weer om de bug te reproduceren
- gebruik een genummerde lijst
- beschrijf de exacte manier om iets te laten gebeuren. Schrijf niet: “Open document”, maar schrijf “In new empty LibO Spreadsheet document, use menu File > Open (LibO dialog) > file type “Text documents” > select attached sample document > double click”.
Als u een pre-built LibreOffice op Linux gebruikt, geeft dan de exacte versies van LibreOffice packages in uw package management system aan. Als u Windows gebruikt, noem dan de exacte bestandsnaam van de installer en de website waarvandaan u het heeft gehaald.
- Het kan handig zijn om informatie toe te voegen over geïnstalleerde en gebruikte lokalisatie (UI language, document language).
- Geef het aan als u 32-bit LibreOffice op een 64-bit (Linux) systeem gebruikt.
- Voeg de package source toe als het niet de officiële LibreOffice build is.
Beschrijf de verwachte werking en de huidige werking.
U kunt een bijlage toevoegen, bijvoorbeeld een schermafdruk of een document. Meestal kunt u met een knop "Print Screen/PrtScn" op uw toetsenbord een schermafdruk maken. Als u dan Windows gebruikt kunt u met een applicatie als Paint het in een bestand plakken.
- Als u een schermafdruk maakt kies dan eerst als taal Engels. Dat kan met ▸ ▸ ▸ .
- U kunt de schermafdrukken ook nog voorzien met commentaar of delen markeren met LibreOffice Draw.
- Als u meer dan een schermafdruk wilt maken dan kunt u ze beter in een bijlage zetten en die bijlage dan als PDF toevoegen. Geef bij elke schermafdruk aan wat u ermee wilt aantonen.
- Als u een document toevoegt om de bug toe te lichten, maak het document dan zo klein als nodig is. Meestal zal voor een bug in Writer toch wel een paragraaf genoeg zijn. Probeer het vinden van uw tekst in het document voor het debuggen zo simpel mogelijk te maken door een herkenbare tekst te gebruiken, bijvoorbeeld AAAAAAAAAA ₂ ZZZZZZZZZZ voor een bug die door dat teken ontstaat.
- Upload elke bijlage / attachment een voor een. Als u er meer dan zes heeft plaats ze dan liever in een zip-bestand zodat er maar een bijlage nodig is.
- Als de upload te groot is als bijlage in Bugzilla (> 1 MB) gebruik dan de deze pagina.
Status
U kunt de status alleen naar NEW wijzigen als iemand ergens de bug al heeft bevestigd (Ask, mailinglijst, forum). Voeg dan een link naar die conversatie toe.
Submit
Klik op Submit om uw rapport op te slaan in de Bugzilla database.
Als het gebruik van Bugzilla te moeilijk is
Als het registreren in het Bugzilla bug tracking systeem te moeilijk is of niet lukt dan kunt u het het probleem melden:
Ook al deelt u hier uw probleem, probeer toch om het in Bugzilla te beschrijven. Via deze twee kanalen kunnen ze u helpen.
Na het rapporteren van een bug
LibreOffice is open source en uw hulp op issues op te lossen is zeer welkom. U kunt:
- Uw ontwikkelaars laten meewerken aan LibreOffice of ze daarmee te leren werken. We ondersteunen ze graag: lees de developer’s pages.
- Particulieren of bedrijven financieren om aan specifieke kwesties te werken - zie de lijst van gecertificeerde developers.
- Contact Mail de Document Foundation om u te helpen als u slechts een klein bedrag aan financiering heeft en wilt samenwerken, coördineren of uw middelen wilt bundelen met anderen in dezelfde situatie om specifieke oplossingen of verbeteringen te financieren.
We zijn dankbaar voor elk ontvangen rapport. Het schrijven van een bugrapport kan vervelend en tijdrovend zijn, maar de tijd die anderen besteden aan het analyseren en uiteindelijk oplossen van een probleem kan in vergelijking tien of soms zelfs honderd keer langer zijn. Wij vragen u dan ook om begrip te hebben en vriendelijk om meer informatie te verstrekken, indien gevraagd. Bovendien bent u met een duidelijk rapport met volledige informatie goed gepositioneerd om uw probleem op te lossen.
Commentaar toevoegen
Voeg geen commentaar toe als "Dat heb ik ook." als u geen zinvolle toevoegingen hebt om het probleem op te lossen. Een uitzondering hierop is het als de bug nog niet bevestigd is (UNCONFIRMED). Voeg in dat geval toe hoe u dat gedaan hebt als de oorspronkelijke beschrijving niet voldoet. Wijzig de status vervolgens in NEW. Als het reproduceren niet eenduidig of helder is dan kan de status snel weer de status krijgen van NEEDINFO, zorg dus dat dit goed beschreven is.
Goede rapporten
Minimale vereisten
- OS/LibreOffice versie
- genummerde reproduceerbare stappen
- eenvoudige bijlagen indien die nodig zijn
- de resultaten en de verwachte resultaten.
Voorbeelden van goede rapporten
- tdf#85004 - Writer: Crash when clicking the Reminder icon on the Navigation toolbar
- tdf#87907 - DIALOG: Page preview in print dialog refreshes when opening print details
- tdf#74839 - EDITING: Position of connectors connected to a group aren't updated when editing group content
Voorbeelden van minder goede rapporten
Problemen die we regelmatig zien:
Een rapport voor 5 onderwerpen
Het rapporteren van meerdere problemen in één ticket - zelfs als ze van invloed zijn op een enkel document - is suboptimaal, vooral op de lange termijn. Een ticket mag 'slechts een enkel probleem melden.
Ontbrekende gegevens / stappen
Een bug rapport moet minimaal bevatten:
- uw Besturingssysteem en de versie van LibreOffice
- heldere reproduceerbare stappen
- verwachte resultaten
- resultaten
- indien nodig een eenvoudige bijlage
Overbodige informatie
Beperk u tot gegevens die nodig zijn om het probleem op te lossen. Waar een ontwikkelaar weinig mee kan zijn opmerkingen als:
- “dit is een blocker”;
- een lange lijst redenen waarom het een blocker is
- “Ik kan hierdoor LibreOffice niet gebruiken”
- “LibreOffice sucks” (of een variatie daarvan)
- “Ik ga maar eens een ander pakket gebruiken als jullie het niet oplossen.”
Complexe bijlagen
Probeer een bijlage zo kort en eenvoudig mogelijk te houden. We zoeken een probleem niet een goedlopend verhaal.
Aannemen dat bijdragers alles weten
Neem niet aan dat iemand begrijpt wat u bedoelt. Beschrijf elke stap helder en nauwgezet.