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

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

Other languages:

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

Тези насоки показват как да направим добро описание на бъг или заявка (задача) в тракера за задачи на Уикимедия (виж Phabricator за повече информация). По-добре описаните задачи имат по-голям шанс за обработка. Задачите трябва да бъдат написани на английски език. Ако не умеете да пишете на английски, опитайте да използвате инструмент за машинен превод, като например Google Translate.

Бързи съвети

Бъдете прецизни

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

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

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

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

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

Използвайте полето за търсене на бъгтракера на Уикимедия, за да видите дали вашия бъг вече не е докладван. Можете също така да извършите по-разширено търсене на страницата за подробно търсене.

Ако не сте сигурни дали за грешката вече е била съобщено, би трябвало да я съобщите. По-добре е да има дублиращи се бъгове, отколкото недокладвани проблеми.

Is it maybe a gadget / user script issue?

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.

Съобщаване за нов бъг или заявка за функция

Ако намерите бъг в последната версия и изглежда, че никой друг не е съобщил за него, тогава:

Отидете на phabricator.wikimedia.org.
Ще бъдете помолени да влезете в системата (или да се регистрирате), ако не сте го направили (вижте "Създаване на потребителска сметка ").
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 ).
Попълнете поне следните полета:
- Title: Кратко обобщение в едно изречение, което обяснява проблема (не предложеното от вас решение).
  - Добро: "Selecting gender is not functional."
  - Лошо: "Software crashes."
- Description: Пълни подробности за проблема, като предоставите цялата информация, с която разполагате в момента. If that is insufficient you will be asked for additional information along with guidance on how to obtain it. This field should include:
  - За бъгове:
    - Steps to Reproduce: Малки, лесни за следване стъпки, които ще задействат описания проблем. Включете всички специални стъпки за настройките.
      Пример:
      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.
    - Actual Results: Реакция на приложението след извършване на горните стъпки.
      Пример:
      "There is no female gender in front of my username."
    - Expected Results: Какво трябваше да направи приложението, ако нямаше бъг.
      Пример:
      "My gender is shown in front of my username."
  - За заявки за функции:
    - Описание на това, което искате да се получи като резултат, и защо. 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.
      Пример:
      "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
  - Хората обикновено предоставят друга информация, която би била от полза, например:
    - уеб браузърите, изгледите или компютърните системи, на които сте видели бъга;
    - връзките до или разликите в една или повече страници, където сте се натъкнали на бъга; или
    - дали проблемът се появява всеки път, само понякога, само на определени страници или само при специфични обстоятелства.
- За да прикачите лог файл или скрийншот (първо се уверете, че не е включена или показана някаква поверителна информация), натиснете бутона Upload File (облак със стрела) в лентата с инструменти на полето Description.
- Изберете tags (проект(и)), на които сте открили бъг:
  - Проектите са способи, с помощта на които разработчиците намират задачите, върху които да работят. За определяне на правилния проект (и), използвайте функцията за търсене (в горния десен ъгъл), за да намерите неговото описание.
  - Това може да бъде например MediaWiki-General-or-Unknown project за самия уикисофтуер, или Wikimedia-Site-Requests за промени в конфигурацията на даден сайт на Уикимедия (вижте Selecting projects ).
- Subscribers: Ако знаете конкретни потребители, които ще бъдат заинтересовани от получаване на известие за тази задача, можете да ги добавите тук. Otherwise, ignore this field.

Проверете дали вашия доклад е пълен, след това натиснете бутона "Create Task". Вашият доклад ще бъде изпратен в базата данни. This allows somebody interested in the report to look at it and potentially work on it .

Приоритетът на задачата ще бъде зададен от разработчиците, които планират да работят по задачата (вижте Задаване на приоритети).

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

Съобщаване за бъг в JavaScript

Вижте също: Help:Locating broken scripts

A lot of functionality, such as gadgets, user scripts, and some parts of MediaWiki, rely on JavaScript.

Когато откриете грешка, която може да бъде свързана с JavaScript, направете всичко възможно да идентифицирате съобщенията за грешка и да ги копирате в доклада.

Особено важно е да предоставите цялата информация, която имате, защото дори и администраторите нямат достъп до всички записи за грешки.

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

Reporting a connectivity issue

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

Reporting a login problem

If you are having problems logging into your account, please follow Manual:How to debug/Login problems .

Notes

↑ phab:T85433 Using Phabricator for gadget-related tasks

Вижте също

[1] :T85433 Using Phabricator for gadget-related tasks

[1]