點樣報告一個bug
- To ask technical questions about Wikimedia projects, see m:Tech
- To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk
呢個指引介紹咗喺維基媒體嘅錯誤追蹤系統（去Phabricator睇更多資訊）點樣寫一個好嘅程式錯誤報告或者功能請求（一個任務），寫得好嘅話，好可能會快啲處理到問題。 而任務需要用英文嚟寫，如果你唔識英文，可以試下用機器翻譯，例如用Google翻譯。
快速建議
- 精準
- Be clear: explain 1) how to reproduce the situation, step by step, without leaving any room for interpretation, 2) expected behavior, 3) actual behavior. In separate sections
- Include only one specific bug or one specific feature request per task
- Include any relevant links and examples
喺你做任何嘢之前
你可唔可以重現呢個問題?
Try to reproduce your bug using a recent version of the software, to see whether it has already been fixed. If the bug is on a wiki site like Wikipedia, you could try testing the latest software version on test2.wikipedia.org.
係咪經已有第啲人報告咗呢個問題?
Use the search box of Wikimedia's bugtracker to see if your bug has already been reported, or the feature requested. You can also perform more advanced searches on the advanced search page.
If you are unsure whether a bug has already been reported, you should report the bug. It is better to have duplicate bugs than it is to have unreported bugs.
呢個係咪一個架撐仔 / 用戸劇本嘅問題?
Some problems are a consequence of using user scripts and gadgets which need some fixes.
There is a guide available with steps how you can identify such code, which could fix your issue so that you do not waste your time reporting it.
Is it a caching issue?
Some issues relate to older cached HTML being served alongside newer JavaScript where the two are incompatible. To help determine if this is the cause it is helpful to purge the page, refresh the page and see if the issue persists and include this information in your bug report.
報個一個新嘅bug或者要求某啲功能
If you have faced a bug in a recent version and no one else appears to have reported it, then:
- Go to phabricator.wikimedia.org.
- You will have to log in (or register) if you have not already done so (see "Creating your account").
- Click the Bookmark button in the upper right corner and choose "Report a Software Bug" (or "Report a Security Issue" to report a security problem).
- Fill out at least the following fields:
- Title: A short one-sentence summary that explains the problem (not your suggested solution).
- 好：
"Selecting gender is not functional on Special:Preferences" - 壞：
"Software crashes"
- 好：
- Description: Full details of the issue, giving all the information you currently have. If that is insufficient you will be asked for additional information along with guidance on how to obtain it. This field should include:
- For bugs:
- Steps to Reproduce: Minimized, easy-to-follow steps that will trigger the described problem. Include any special setup steps.
- Example:
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.
- Example:
- Actual Results: What the application did after performing the above steps.
- Example:
"There is no female gender in front of my username."
- Example:
- Expected Results: What the application should have done, if there was no bug.
- Example:
"My gender is shown in front of my username."
- Example:
- Steps to Reproduce: Minimized, easy-to-follow steps that will trigger the described problem. Include any special setup steps.
- For feature requests:
- A description of what you would like to achieve, and why. Explain what you hope the feature will solve (the actual underlying problem) along with specific examples; but do not demand a specific solution, as there might be other/better solutions. 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. Explain what you hope the feature will solve (the actual underlying problem) along with specific examples; but do not demand a specific solution, as there might be other/better solutions. A user story is an effective way of conveying this.
- Please also provide any other information that might be useful, such as:
- the web browsers, skins, or computer systems you've seen the bug on;
- links or diffs to one or more pages where you encountered the bug; or
- whether the problem appears every time, only occasionally, only on certain pages, or only in specific circumstances.
- For bugs:
- 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.
- Select the tags (project(s)) in which you've found the bug:
- Projects are how developers find tasks to work on. To identify the right project(s), use the search function (in the top right) to find its description.
- This could be for example the
MediaWiki-Generalproject for the wiki software itself, orWikimedia-Site-Requestsfor configuration changes on a Wikimedia site (see Selecting projects).
- Subscribers: If you know specific users who will be interested in getting notified of this task you can add them here. Otherwise, ignore this field.
- Title: A short one-sentence summary that explains the problem (not your suggested solution).
Check if your report is complete, then press the "Create Task" button. Your report will now be in the database. This allows somebody interested in the report to look at it and potentially work on it.
The priority for the task will be set by developers if they plan to work on the task (see Setting priorities).
That's all! Thanks for your help to improve MediaWiki and Wikimedia projects!
報告關於JavaScript嘅bug
- See also: Help:Locating broken scripts
A lot of functionality, such as gadgets, user scripts, and some parts of MediaWiki, rely on JavaScript.
When you encounter a bug that may be related to JavaScript, do your best to identify error messages and copy them into the bug report.
It's especially important to provide all the information you have, because even the system administrators will have zero access to any error log.
If the problem is in the code of a user script or gadget itself, then Phabricator might not be the place where the problem will get handled.[1] Someone might redirect you to the talk page of the script (if the problematic script is identified).
報告關於連通性嘅問題
If you are having difficulties reaching a Wikimedia website at all (slow internet connection etc.), please follow https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue
報告關於簽到嘅問題
If you are having problems logging into your account, please follow Manual:How to debug/Login problems.
註
睇埋
- How to Report Bugs Effectively by Simon Tatham