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

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page How to report a bug and the translation is 83% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Cymraeg • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Kreyòl ayisyen • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Ripoarisch • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎hrvatski • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎shqip • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎српски / srpski • ‎татарча/tatarça • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎मराठी • ‎हिन्दी • ‎মেইতেই লোন্ • ‎ਪੰਜਾਬੀ • ‎ଓଡ଼ିଆ • ‎தமிழ் • ‎తెలుగు • ‎ಕನ್ನಡ • ‎සිංහල • ‎ไทย • ‎ქართული • ‎ትግርኛ • ‎ᱥᱟᱱᱛᱟᱲᱤ • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
shortcut: BUGREPORT

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

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

Бързи съвети

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

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

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

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

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

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

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

Have you tried fixing the issue yourself?

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.

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

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

  1. Отидете на phabricator.wikimedia.org и натиснете "Tasks & bugs" в страничната лента.
  2. Изберете "Create task" в горния десен ъгъл.
  3. Ще бъдете помолени да влезете в системата (или да се регистрирате), ако не сте го направили (вижте "Създаване на потребителска сметка ").
  4. Попълнете поне следните полета:
    • Title: Кратко обобщение в едно изречение, което обяснява проблема (не предложеното от вас решение).
      • Добро: "Selecting gender is not functional."
      • Лошо: "Software crashes."
    • Assigned to: Би следвало да игнорирате това поле: Когато разработчиците планират работата по задачата, те ще определят лицето на което да я възложат.
    • 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 user name."
        • Expected Results: Какво трябваше да направи приложението, ако нямаше бъг.
          Пример:
          "My gender is shown in front of my user name."
      • За заявки за функции:
        • Описание на това, което искате да се получи като резултат, и защо. Ефективен начин за това е потребителски разказ.
          Пример:
          "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". Вашият доклад ще бъде изпратен в базата данни, и се надяваме, че някой скоро ще го разгледа.

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

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

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

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

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

Особено важно е да предоставите цялата информация, която имате, защото дори и администраторите нямат достъп до всички записи за грешки. Ако не сте сигурни дали функцията, която използвате, е базирана на 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 wikitech: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.

Вижте също

  • phab:T85433