Hur du rapporterar en bugg
Dessa riktlinjer förklarar hur du skriver en bra buggrapport eller ett funktionsönskemål i Wikimedias buggspårare (se Bugzilla för mer information). Effektiva buggrapporter är de som mest troligt blir fixade.
Pröva det nya guidade formuläret för att rapportera buggar!
Buggrapporter måste göras på engelska. Om du inte kan skriva på engelska, försök att använda ett verktyg för maskinöversatt text, exempelvis Google Translate.
Contents
Korta rekommendationer för rapportering[edit | edit source]
- Var exakt
- Var tydlig: förklara hur problemet kan återskapas, steg för steg, så att andra återskapa buggen.
- Inkludera enbart ett problem per rapport
Innan du börjar[edit | edit source]
Kan du återskapa problemet?[edit | edit source]
Försök att återskapa buggen i den senaste versionen av mjukvaran, för att se om den redan är fixad. Om buggen är på en sida som Wikipedia kan du testa den senaste mjukvaruversionen på test2.wikipedia.org.
Har någon annan redan rapporterat problemet?[edit | edit source]
Använd sökrutan på bugzilla.wikimedia.org för att se om din bugg redan har rapporterats. Du kan även utföra mer avancerade sökningar på söksidan.
Att rapportera en ny bugg eller ett funktionsönskemål[edit | edit source]
Om du har påträffat en bugg i en nyare mjukvaruversion och ingen annan verkar ha rapporterat den, så:
- Gå till bugzilla.wikimedia.org.
- Välj "Enter a new bug".
- Du kommer att bli ombedd att logga in (eller registrera dig) om du inte redan gjort detta (se "Varför måste jag registrera mig??").
- Välj den produkt i vilken du hittat buggen:
- Detta kan exempelvis vara MediaWiki för själva wiki-mjukvaran, eller Wikimedia för konfigurationsändringar på Wikimedias wiki-webbplatser.
- Fyll i åtminstone följande fält:
- Component (komponent): Den del av mjukvaran som buggen inträffade i. Till höger kan duse beskrivningar för var komponent. Om ingen verkar passa använd General/Unknown.
- Severity (allvarlighet): Om du begär en ny funktionalitet sätt allvarlighet till enhancement.
- Summary (sammanfattning): En kort sammanfattning på en mening som förklarar problemet (inte din föreslagna lösning).
- Bra: "Selecting Gender is not functional."
- Dåligt: "Software crashes."
- Description (beskrivning): Fullständig information om problemet, var så detaljerad som möjligt. Detta kan inkludera:
- For bugs:
- Steg för att reproducera problemet: Minimalistiska, enkla att följa steg-för-steg instruktioner som reproducerar problemet. Inkludera eventuella speciella förinställningssteg.
- Exempel:
- Go to https://en.wikipedia.org with Internet Explorer version 10.0;
- Make sure you are logged in;
- Select "My Preferences" menu;
- Go to "Gender" and select female gender from box list;
- Click 'Save' button.
- Exempel:
- Faktiska resultat: Vad applikationen gjorde efter att ovanstående steg utförts.
- Exempel:
- "There is no female gender in front of my user name."
- Exempel:
- Förväntade resultat: Vad applikationen skulle ha gjort, om det inte funnits en bugg.
- Exempel:
- "My gender is shown in front of my user name."
- Exempel:
- Steg för att reproducera problemet: Minimalistiska, enkla att följa steg-för-steg instruktioner som reproducerar problemet. Inkludera eventuella speciella förinställningssteg.
- For feature requests:
- A description of what you would like to achieve, and why. A user story is an effective way of conveying this.
- Example:
- "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
- Example:
- A description of what you would like to achieve, and why. A user story is an effective way of conveying this.
- Vänligen ange även eventuell annan information som kan vara hjälpsam, som exempelvis:
- webbläsaren, temat eller operativsystemet som du såg buggen på;
- länkar eller diffar till en eller fler sidor där du påträffade buggen; eller
- om problemet uppstår var gång, enbart ibland, enbart på särskilda sidor, eller enbart under speciella omständigheter.
- For bugs:
- Attachment (bifogning): Du kan bifoga en loggfil eller en skärmdump (men se till att ingen konfidentiell information inkluderas eller visas).
Kolla om din rapport är komplett, tryck sedan på "Submit bug"-knappen. Din buggrapport finns nu i databasen och någon kommer förhoppningsvis snart att titta på den.
Det var allt! Tack för din hjälp med att förbättra MediaWiki och Wikimediaprojekten!
Se även[edit | edit source]
- How to Report Bugs Effectively av Simon Tatham
- BugZilla sången
- Wikipedia: Buggrapporter och funktionsönskemål (på engelska)