Writing a good bug report or feature request

Translate This Post

phab-1
Overview of bug creation. Photo by Sammy Tarling, freely licensed under CC BY 3.0.

A software bug is an error or flaw in a computer program that produces incorrect or unintended results. Developers try to produce software that works as intended, but mistakes are inevitable. Wikimedia uses a system called Phabricator to organize software development and manage these bugs and feature requests.

phab-2

Pre-cropped closeup of bug creation. Click for a larger image. Photo by Sammy Tarling, freely licensed under CC BY 3.0.

When you find a bug and submit a report to Wikimedia, it is important to provide as much information as possible, including good steps to reproduce the bug. Offering information that might be relevant—like the complete address of the page on which the problem happens and the web browser or the MediaWiki skin that you are using—helps developers replicate and fix the problem quicker. When you come across an issue you would like to report, it is very welcome to confirm the issue is not an intermittent one and can be reproduced.

After you have confirmed that the problem can be reproduced and have made note of the steps you took, it is time to visit Phabricator.

Creating a bug report or feature request requires the use of an account. Click the icon in the upper right corner and use your MediaWiki account by clicking the sunflower at the bottom of the log-in screen.

Once you are logged in, click the little ‘+’ in the top right corner and choose ‘Create New Task’. Now you can enter information about your discovered bug or feature request in a so-called “task”.

phab-3

Screen displayed after bug is successfully created. Click for a larger image. Photo by Sammy Tarling, freely licensed under CC BY 3.0.

The first step is choosing a descriptive yet concise title for your task. Titles such as “When clicking edit, my browser crashes” are much better than “cannot edit”. The next step will be selecting which project you have found the bug in. If you are unsure you can just enter ‘MediaWiki-General-or-Unknown’ in the ‘Projects’ field. Someone else who takes a look at your report might change the project to a more specific one so it becomes easier for the corresponding project developers to find your report.

In the description you are encouraged to give the following information:

  • The steps you took to reproduce the issue (e.g. Load https://en.wikipedia.org/wiki/Example, then click ‘edit’)
  • What you expected to happen (e.g. I would be able to edit the article)
  • What actually happened (e.g. My browser stopped responding and crashed. I was using Firefox 40.0.3 on Windows 7)
  • Any other information which you think will help the developers understand and reproduce the problem

Once all relevant information and detail you can think of is in the bug report’s description, click the “Create Task” button at the bottom of the page. That’s it! Your bug report has now been created and everybody can take a look at it. Do not worry: if more information is needed, someone else will ask for it.

Thank you for helping make Wikimedia websites and MediaWiki become better! More information on Phabricator can be found on its help page, as well as a more detailed guide to reporting bugs and feature requests.

Sammy Tarling
Tech Ambassador

Archive notice: This is an archived post from blog.wikimedia.org, which operated under different editorial and content guidelines than Diff.

Can you help us translate this article?

In order for this article to reach as many people as possible we would like your help. Can you translate this article to get the message out?

16 Comments
Inline Feedbacks
View all comments

I wrote a “bug report” and sent it (as usual with security related information) via PGP to the responsible person (who provided me with his private e-mail account to use PGP). That was on August 27, 2015 – no feedback since then. I’ll suggest that you create a Wikipedia article how to handle security related information and confirm each request with a unique ticket number instead of allowing a Wikipedia employee to take over the information on his private e-mail account and never come back to the original question. I’ll guess that I can also sell the information I provided… Read more »

Hi Marco 漢堡包! I’m sorry to hear that you have not heard back yet. https://www.mediawiki.org/wiki/Security describes how to report Security issues – can you please report the problem again either via email or in Phabricator, as described on that page? Thanks in advance and again sorry that this has not been taken care of.

OK, for the records: a) Andre Klapper sent me a message that he replyed on this blog, which is very cool! b) but than he ask me to send the same thing again c) I rejected his suggestion to forward him the details by e-mail (it’s still not sure if it’s a security related issue or not) d) I asked him to contact they guys at: info-en@wikimedia.org as it looks to me, that they work for the same Organization. e) Thursday 15. October 2015 6pm in my timezone still no further news. Will drop an update once my report arrived… Read more »

Dear Andre
My personal advise (for the future), please inform the people at: info-en@wikimedia.org that you have a simple process here: https://www.mediawiki.org/wiki/Security
If that would be the case, we don’t need to do “history coping”.
Cheers!
Marco

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little '+' in the top right corner and choose 'Create New Task'. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‚+‘ in the top right corner and choose ‚Create New Task‘. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]

[…] Writing a good bug report or feature request – Wikimedia Blog 14 Oct 2015 … You can help report bugs on our software issue tracker. … software development and manage these bugs and feature requests. … click the little ‘+’ in the top right corner and choose ‘Create New Task’. … Tech Ambassador … […]