Как да опишем бъг

This page is a translated version of the page How to report a bug and the translation is 48% 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.

Описанията на бъговете трябва да бъдат на английски език. Ако не умеете да пишете на английски, опитайте да използвате инструмент за машинен превод, като например Google Translate.

Няколко бързи съвета за докладите

• Бъдете прецизни
• Бъдете ясни: обяснете как се стига до проблема стъпка по стъпка, така че и другите да могат да възпроизведат бъга
• Включвайте само по един проблем на описание

Преди да предприемете стъпките

Можете ли да възпроизведете проблема?

Опитайте се да възпроизведете бъга, използвайки текущата версия на софтуера, за да видите дали той вече е бил отстранен. Ако грешката е на уики сайт като Уикипедия, можете да изпробвате най-новата версия на софтуера на test2.wikipedia.org.

Дали някой друг вече е съобщил за проблема?

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.

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 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. 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."
     • Лошо: "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.
   • Описание: Опишете подробно, включвайки възможно най-много подробности. Това може да бъде:
     • For bugs:
       • Steps to Reproduce: Minimized, easy-to-follow steps that will trigger the described problem. Include any special setup steps.

         Пример:

         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.

         Пример:

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

       • Очаквани резултати: Какво трябваше да направи приложението, ако нямаше бъг.

         Пример:

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

         Пример:

         "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"

     • Хората обикновено предоставят друга информация, която би била от полза, например:
       • уеб браузърите, изгледите или компютърните системи, на които сте видели бъга;
       • връзките до или разликите в една или повече страници, където сте се натъкнали на бъга; или
       • дали проблемът се появява всеки път, само понякога, само на определени страници или само при специфични обстоятелства.
   • 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.

Това е всичко! Благодарим за вашата помощ с цел подобрение на MediaWiki и проектите на Wikimedia!

Виж също

• How to Report Bugs Effectively by Simon Tatham
• Wikipedia: Bug reports and feature requests