Jump to content

Bugzilla: Difference between revisions

From IdeaWazaWiki
wikademia>Alex Smotrov
+ syntax section (not sure if 100% correct), + note that email is visible
wikademia>Alex Smotrov
restructuring
Line 1: Line 1:
[[Image:Computer bug.svg|right|200px|All your bug are belong to me!]]
[[Image:Computer bug.svg|right|200px|All your bug are belong to me!]]
All bugs in the MediaWiki software should be reported at [http://bugzilla.wikimedia.org/ bugzilla.wikimedia.org].  This is also the place to request new features or enhancements to existing features, although bear the following points in mind before making a feature/enhancement request:
'''Bugzilla''' is a site [http://bugzilla.wikimedia.org/ bugzilla.wikimedia.org] to report bugs in the [[MediaWiki]] software and request new features or enhancements.
* If the request is specific to a Wikimedia wiki, please discuss the issue on that wiki first.
* Consider whether a custom [[Extension:Contents|extension]] would be more appropriate.
 


== What is Bugzilla? ==
== What is Bugzilla? ==


Bugzilla is our on-line bug-tracking tool, and it is where any bugs in the MediaWiki software should be reported. It can also be used to request new features or enhancements, although you should consider whether the feature is better suited to an [[Extension:Contents|extension]] first.
Bugzilla is also a name of on-line bug-tracking tool, which is used on a lot of other websites. For more information see [[w:Bugzilla|Wikipedia article on Bugzilla]].  


The reason we use Bugzilla is that it allows the developers to easily find, track and discuss issues, to spot duplicate issues and ultimately to resolve them.
The reason we use Bugzilla is that it allows the developers to easily find, track and discuss issues, to spot duplicate issues and ultimately to resolve them.


For more information, see [[w:Bugzilla|the Wikipedia article on Bugzilla]].
Wikimedia Bugzilla site is sometimes referred as Mediazilla.
 
Note that, in some places, the software is referred to as Mediazilla.


== How do I report a bug? ==
== Reporting a bug ==


# Go to [http://bugzilla.wikimedia.org bugzilla.wikimedia.org].
# Go to [http://bugzilla.wikimedia.org bugzilla.wikimedia.org].
Line 28: Line 23:


That's it!  For maximum chance of your bug being fixed, you are advised to read the [http://bugzilla.wikimedia.org/page.cgi?id=bug-writing.html bug writing guidelines] first.
That's it!  For maximum chance of your bug being fixed, you are advised to read the [http://bugzilla.wikimedia.org/page.cgi?id=bug-writing.html bug writing guidelines] first.
== Requesting a feature ==
Before making a feature/enhancement request:
* Consider whether a custom [[Extension:Contents|extension]] would be more appropriate.
* If the request is specific to a Wikimedia wiki, please discuss the issue on that wiki first. Devs will usually ask you for a link showing a community consensus.
Then follow the same directions as above, except you probably need to select 'Wikimedia' instead of 'MediaWiki'.


== What syntax can I use? ==
== What syntax can I use? ==
Line 36: Line 39:
* bug 23456, comment 53
* bug 23456, comment 53
* attachment 4321
* attachment 4321
MediaWiki-style internal links are also supported, by default they point to English Wikipedia, but you can use most interwiki or project prefixes.
MediaWiki-style internal links are also supported, by default they point to English Wikipedia. It seems like some interwiki or project prefixes are supported as well, but you cannot specify the <code>|name]]</code> of the link.


== Why must I register? ==
== Why must I register? ==

Revision as of 18:59, 18 January 2008

All your bug are belong to me!
All your bug are belong to me!

Bugzilla is a site bugzilla.wikimedia.org to report bugs in the MediaWiki software and request new features or enhancements.

What is Bugzilla?

Bugzilla is also a name of on-line bug-tracking tool, which is used on a lot of other websites. For more information see Wikipedia article on Bugzilla.

The reason we use Bugzilla is that it allows the developers to easily find, track and discuss issues, to spot duplicate issues and ultimately to resolve them.

Wikimedia Bugzilla site is sometimes referred as Mediazilla.

Reporting a bug

  1. Go to bugzilla.wikimedia.org.
  2. Use the search box on the main page to see if your bug has already been submitted. You can also perform more advanced searches on the search page.
  3. If you are sure that your issue has not already been reported then click enter a new bug in the toolbox on the left. You will be prompted to login if you have not already done so (see 'Why must I register?', below).
  4. Select 'MediaWiki' as the product.
  5. Fill in the following boxes (the rest can be left blank):
    • Component (if you don't know, select 'General/Unknown')
    • Summary - a short one-sentence summary of the issue
    • Description - full details of the issue, giving as much detail as possible
  6. Click 'Commit'

That's it! For maximum chance of your bug being fixed, you are advised to read the bug writing guidelines first.

Requesting a feature

Before making a feature/enhancement request:

  • Consider whether a custom extension would be more appropriate.
  • If the request is specific to a Wikimedia wiki, please discuss the issue on that wiki first. Devs will usually ask you for a link showing a community consensus.

Then follow the same directions as above, except you probably need to select 'Wikimedia' instead of 'MediaWiki'.

What syntax can I use?

Bugzilla comments are plain text, you cannot use HTML. However, Bugzilla will automatically make hyperlinks for certain type of text in comments:

MediaWiki-style internal links are also supported, by default they point to English Wikipedia. It seems like some interwiki or project prefixes are supported as well, but you cannot specify the |name]] of the link.

Why must I register?

We need you to register in order to use Bugzilla. This is primarily so that we can contact you if there are further questions regarding your bug submission. For example, if a developer is unable to replicate your problem they will ask for more information.

Registering is free and easy. Simply click the 'create account' link at the top right of the page, enter your e-mail address (and optionally your real name) and click 'create account'. Then simply login using the password you receive in the confirmation e-mail (which can be changed in your preferences once you have logged in).

Once logged in, you can change your preferences to specify what kinds of e-mail Bugzilla sends you (with the option of turning off all e-mail). To do this click 'my preferences' in the top right and select the 'email settings' tab.

Please note that (unlike on Wikimedia projects) your email address will be visible to everyone. Some people prefer to set up a separate e-mail account (using a free webmail service) for working with Bugzilla.

Why can't I report bugs here?

You can. You can also report by writing them in chalk on the pavement. However, if you want a developer to act on it then you need to put it somewhere they are likely to see it, namely Bugzilla.

If you want to create a link from a page on MediaWiki.org to a Bugzilla bug, use [[bugzilla:XXX]], where XXX is the bug number you want to link to. For example [[bugzilla:4198]] will result in the following output: bugzilla:4198.