How to report a bug/bg

Тези насоки показват как да направим добро описание на бъг или заявка за нова функционалност на бъгтракера на Уикимедия (виж за повече информация). По-вероятно е да бъдат отстранени добре описаните бъгове.

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

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

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

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

Съобщаване за нов бъг или заявка за функция
Ако намерите бъг в последната версия и изглежда, че никой друг не е съобщил за него, тогава:
 * 1) Отидете на  phabricator.wikimedia.org и натиснете "Maniphest" в страничната лента.
 * 2) Изберете "Create task" в горния ъгъл.
 * 3) Ще бъдете помолени да влезете в системата (или да се регистрирате), ако не сте го направили (вижте "").
 * 4) Попълнете поне следните полета:
 * 5) * Title: Кратко обобщение в едно изречение, което обяснява проблема (не предложеното от вас решение).
 * 6) ** Добро:
 * 7) ** Лошо:
 * 8) * Assigned to: Би следвало да игнорирате това поле: Когато разработчиците планират работата по задачата, те ще определят лицето на което да я възложат.
 * 9) *  'Priority:' Би следвало да игнорирате това поле. По принцип, приоритетът се задава от разработчиците, които планират да работят по задачата (see Задаване на приоритети).
 * 10) * Description: Опишете подробно, включвайки възможно най-много подробности. Това може да включва:
 * 11) ** За бъгове:
 * 12) *** Steps to Reproduce: Малки, лесни за следване стъпки, които ще задействат описания проблем. Включете всички специални стъпки за настройките.
 * Пример:
 * 1) *** Actual Results: Реакция на приложението след извършване на горните стъпки.
 * Пример:
 * 1) ***Expected Results: Какво трябваше да направи приложението, ако нямаше бъг.
 * Пример:
 * 1) ** За заявки за функции:
 * 2) *** Описание на това, което искате да се получи като резултат, и защо. Ефективен начин за това е потребителски разказ.
 * Пример:
 * 1) **Хората обикновено предоставят друга информация, която би била от полза, например:
 * 2) ***уеб браузърите, изгледите или компютърните системи, на които сте видели бъга;
 * 3) ***връзките до или разликите в една или повече страници, където сте се натъкнали на бъга; или
 * 4) ***дали проблемът се появява всеки път, само понякога, само на определени страници или само при специфични обстоятелства.
 * 5) *За да прикачите лог файл или (първо се уверете, че не е включена или показана някаква поверителна информация), натиснете бутона Upload File (облак със стрела) в лентата с инструменти на полето Description.
 * 6) * Изберете tags (проект(и)), на които сте открили бъг:
 * 7) **Проектите са способи, с помощта на които разработчиците намират задачите, върху които да работят. За определяне на правилния проект (и), използвайте функцията за търсене (в горния десен ъгъл), за да намерите неговото описание.
 * 8) **Това може да бъде например project за самия уикисофтуер, или  за промени в конфигурацията на даден сайт на Уикимедия (вижте "").
 * 9) * Subscribers: Би следвало да игнорирате това поле: Ако знаете конкретни потребители, които ще бъдат заинтересовани от получаване на известие за тази задача, можете да ги добавите тук.
 * 1) ***уеб браузърите, изгледите или компютърните системи, на които сте видели бъга;
 * 2) ***връзките до или разликите в една или повече страници, където сте се натъкнали на бъга; или
 * 3) ***дали проблемът се появява всеки път, само понякога, само на определени страници или само при специфични обстоятелства.
 * 4) *За да прикачите лог файл или (първо се уверете, че не е включена или показана някаква поверителна информация), натиснете бутона Upload File (облак със стрела) в лентата с инструменти на полето Description.
 * 5) * Изберете tags (проект(и)), на които сте открили бъг:
 * 6) **Проектите са способи, с помощта на които разработчиците намират задачите, върху които да работят. За определяне на правилния проект (и), използвайте функцията за търсене (в горния десен ъгъл), за да намерите неговото описание.
 * 7) **Това може да бъде например project за самия уикисофтуер, или  за промени в конфигурацията на даден сайт на Уикимедия (вижте "").
 * 8) * Subscribers: Би следвало да игнорирате това поле: Ако знаете конкретни потребители, които ще бъдат заинтересовани от получаване на известие за тази задача, можете да ги добавите тук.

Проверете дали вашия доклад е пълен, след това натиснете бутона "Create Task". Вашият доклад ще бъде изпратен в базата данни, и се надяваме, че някой скоро ще го разгледа.

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

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

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

Винаги е добре да включвате скрийншот (екранен кадър) в съобщението си. Често, това е най-лесния начин да се определи коя функция описвате, и често може да предостави информация, която да ви помогне да ограничите последствията от грешката. Погрижете се да скриете всяка информация, която не искате да споделяте, като например други отворени раздели на браузъри или минимизирани чат прозорци.

Вижте също

 * Как ефективно да съобщаваме за грешки от Саймън Теъм
 * Уикипедия: Съобщения за грешки и заявки за функции
 * Етикет на Инкубатор
 * Управление на грешките/ Жизнен цикъл на доклад за грешки
 * Написване на добър доклад за бъгове или заявка за функции
 * Как да създадете добър първи доклад за бъг (остаряло)