Hou tae report ae bug

This page is a translated version of the page How to report a bug and the translation is 59% complete.

---

These guidelines explain how to write a good bug report or feature request in Wikimedia's bugtracker (see Phabricator for more information). Effective bug reports are the most likely to be fixed.

Bug reports need tae be witten in Ingils. Gif ye canna write in Ingils, gie uisin ae machine owersetin tuil like Google Translate ae shot.

Quick recommendations fer reports

• Be precise
• Be clear: explain hou tae reproduce the proablem, step bi step, sae that ithers can reproduce the bug
• Incluid yinlie the ae proablem per report

Afore ye dae oniething

Can ye reproduce the issue?

Gie reproduicin yer bug ae shot uisin ae recynt version o the safware, tae see whither it haes awreadie been fixt. Gif the bug is oan ae wiki steid like Wikipædia ye coud gie testin the latest saffware version ae shot oan test2.wikipedia.org.

Haes some ither bodie awreadie reported the issue?

Use the search box of Wikimedia's bugtracker to see if your bug has already been reported. You can also perform more advanced searches on the advanced search page.

Reportin ae new bug or featur request

Gif ye'v faced ae bug in ae recynt version n nae ither bodie appears tae'v reported it, than:

1. Go to phabricator.wikimedia.org and click "Maniphest" in the side bar.
2. Choose "Create task" in the upper corner.
3. You will be asked to log in (or register) if you have not already done so (see "Creating your account").
4. Fil oot at least the follaein fields:
   • Title: A short one-sentence summary that explains the problem (not your suggested solution).
     • Guid: "Selecting Gender is not functional."
     • Bad: "Software crashes."
   • Assigned to: You can ignore this field: Developers will set an assignee when they plan to work on the task.
   • CC: You can ignore this field: If you know specific users who will be interested in getting notified of this task you can add them here.
   • Priority: You can ignore this field: In general, the priority is set by developers who plan to work on the task (see "Setting priorities").
5. Select the project(s) in which you've found the bug:

   This could be for example the MediaWiki-General-or-Unknown project for the wiki software itself, or Wikimedia-General-or-Unknown for configuration changes of the Wikimedia wiki sites (see "Selecting projects").

   • Security: Set this to "Security or Sensitive bug" if many users could be harmed by the security problem that you are reporting. Your report will be kept hidden from the public until it is resolved.
   • Descreeption: Ful details o the issue, giein aes muckle detail aes possible. This can incluid:
     • For bugs:
       • Steps tae Reproduce: Makit-smaaest, easie-tae-follae steps that will trigger the descreebed proablem. Incluid onie byordinair setup steps.

         Example:

         1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
         2. Make sure you are logged in;
         3. Select "My Preferences" menu;
         4. Go to "Gender" and select female gender from box list;
         5. Click 'Save' button.

       • Actual Ootcomes: Whit the appleecation did efter performin the abuin steps.

         Example:

         "There is no female gender in front of my user name."

       • Expected Ootcomes: Whit the appleecation shid hae dun, gif thaur wis nae bug.

         Example:

         "My gender is shown in front of my user name."

     • 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"

     • Please provide onie ither information that micht be uissfu ava, like:
       • the wab brousers, skins, or computer systems that ye'v seen the bug oan;
       • links or diffs til yin or mair pages whaur ye encountered the bug; or
       • whither the proablem kiths ilka time, yinlie occasionlie, yinlie oan certain pages, or yinlie in speceefeec circumstances.
   • To attach a log file or screenshot (but make sure that no confidential data is included or shown), click the Upload File button (a cloud with an arrow) in the tool bar of the Description field.

Check if your report is complete, then press the "Create Task" button. Your report will now be in the database and somebody will hopefully take a look at it soon.

That's it! Thanks fer yer heelp tae impruiv MediaWiki n Wikimedia waurks!

See ava

• How to Report Bugs Effectively by Simon Tatham
• Wikipædia: Bug reports n featur requests