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

съкращение: BUGREPORT
From mediawiki.org
This page is a translated version of the page How to report a bug and the translation is 80% 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

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

Бързи съвети

  • Бъдете прецизни
  • Бъдете ясни: обяснете 1) как да възпроизвеждате ситуацията, стъпка по стъпка, без да оставите място за интерпретация, 2) очакваното поведение, 3) действителното поведение. В отделни секции
  • Включете само една специфична грешка или една специфична заявка за функция на задача
  • Включете всички съответни връзки и примери

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

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

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

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

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

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

Is it maybe a gadget / user script issue?

Някои проблеми са резултат от използването на и гаджети, които се нуждаят от някои поправки.

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.

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

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

  1. Отидете на phabricator.wikimedia.org.
  2. Ще бъдете помолени да влезете в системата (или да се регистрирате), ако не сте го направили (вижте "Създаване на потребителска сметка ").
  3. 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 ).
  4. Попълнете поне следните полета:
    • Title: Кратко обобщение в едно изречение, което обяснява проблема (не предложеното от вас решение).
      • Добро: "Selecting gender is not functional on Special:Preferences"
      • Лошо: "Software crashes"
    • Description: Пълни подробности за проблема, като предоставите цялата информация, с която разполагате в момента. Ако това не е достатъчно, ще бъдете помолени за допълнителна информация, заедно с указания за това как да я получите. Това поле следва да включва:
      • За бъгове:
        • Steps to Reproduce: Малки, лесни за следване стъпки, които ще задействат описания проблем. Включете всички специални стъпки за настройките.
          Пример:
          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: Реакция на приложението след извършване на горните стъпки.
          Пример:
          "There is no female gender in front of my username."
        • Expected Results: Какво трябваше да направи приложението, ако нямаше бъг.
          Пример:
          "My gender is shown in front of my username."
      • За заявки за функции:
        • Описание на това, което искате да се получи като резултат, и защо. Обяснете какво се надявате да реши характеристиката (действителния основен проблем) заедно с конкретни примери; но не изисквайте конкретно решение, тъй като може да има други/по-добри решения. 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: Ако знаете конкретни потребители, които ще бъдат заинтересовани от получаване на известие за тази задача, можете да ги добавите тук. В противен случай, игнорирайте това поле.

Проверете дали вашия доклад е пълен, след това натиснете бутона "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

Вижте също