Cách báo cáo lỗi

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


Phabricator is for software bug reports, feature requests, and planning work.
  • To ask technical questions about Wikimedia projects, see m:Tech
  • To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk

These guidelines explain how to write a good bug report or feature request (a task) in Wikimedia's task tracker (see Phabricator for more information). Well-written tasks are more likely to be worked on quickly.

Tasks need to be written in English. If you can't write in English, try using a machine translation tool like Google Translate.

Các khuyến nghị chung

  • Hãy chính xác
  • Hãy rõ ràng: giải thích cách thực hiện để xuất hiện lỗi, từng bước một, để những người khác có thể thực hiện lại và hiểu yêu cầu của bạn.
  • Chỉ bao gồm một lỗi cụ thể hoặc một yêu cầu tính năng cụ thể cho mỗi tác vụ
  • Chỉ gồm các liên kết và ví dụ liên quan

Trước khi bạn làm bất cứ điều gì

Bạn có thể tạo lại lỗi đó không?

Cố gắng tái tạo lỗi của bạn bằng cách sử dụng một phiên bản gần đây của phần mềm, để xem nó đã được sửa chưa. Nếu lỗi nằm trên một trang web wiki như Wikipedia, bạn có thể thử thử nghiệm phiên bản phần mềm mới nhất trên test2.wikipedia.org.

Đã có ai đó khác báo cáo vấn đề chưa?

Sử dụng hộp tìm kiếm của Bugtracker của Wikimedia để xem lỗi của bạn đã được báo cáo chưa hoặc tính năng được yêu cầu. Bạn cũng có thể thực hiện các tìm kiếm nâng cao hơn trên tắm tìm kiếm nâng cao.

Nếu bạn không chắc chắn liệu một lỗi đã được báo cáo hay chưa, bạn nên báo cáo lỗi. Tốt hơn là có lỗi trùng lặp hơn là có lỗi không được báo cáo.

Nó có thể là vấn đề về tiện ích / đoạn mã người dùng không?

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.

Reporting a new bug or feature request

If you have faced a bug in a recent version and no one else appears to have reported it, then:

  1. Go to phabricator.wikimedia.org.
  2. You will have to log in (or register) if you have not already done so (see "Creating your account ").
  3. Click the Bookmark button in the upper right corner and choose "Create Task" (or "Report Security issues" to report a security problem ).
  4. Fill out at least the following fields:
    • Title: A short one-sentence summary that explains the problem (not your suggested solution).
      • Tốt: "Selecting gender is not functional."
      • Tệ: "Software crashes."
    • Assigned to: You should ignore this field: Developers will set an assignee when they plan to work on the task.
    • 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:
      • Về các lỗi:
        • Steps to Reproduce: Minimized, easy-to-follow steps that will trigger the described problem. Include any special setup steps.
          Ví dụ:
          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 Results: What the application did after performing the above steps.
          Ví dụ:
          "There is no female gender in front of my username."
        • Expected Results: What the application should have done, if there was no bug.
          Ví dụ:
          "My gender is shown in front of my username."
      • Về yêu cầu về tính năng mới:
        • 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.
          Ví dụ:
          "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
      • 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.
    • 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-General-or-Unknown project for the wiki software itself, or Wikimedia-Site-Requests for 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.

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).

Thế là hết! Cảm ơn về sự giúp đỡ của bạn để phát triển MediaWiki và các dự án Wikimedia!

Báo cáo lỗi JavaScript

Xem thêm: 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).

Báo cáo lỗi kết nối

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

Báo cáo lỗi đăng nhập

Nếu bạn có vấn đề đăng nhập vào tài khoản của mình, xin hãy theo Manual:How to debug/Login problems.

Ghi chú

Xem thêm