Як повідомити про помилку

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 100% complete.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Cymraeg • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Ripoarisch • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎galego • ‎hrvatski • ‎interlingua • ‎italiano • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎shqip • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎српски / srpski • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎अवधी • ‎मराठी • ‎हिन्दी • ‎বাংলা • ‎ਪੰਜਾਬੀ • ‎தமிழ் • ‎తెలుగు • ‎ಕನ್ನಡ • ‎සිංහල • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎한국어
shortcut: BUGREPORT

Ці настанови пояснюють, як написати хороший звіт про помилку чи запит на нову функцію (завдання) на баґтрекері Вікімедіа (див. детальніше Фабрикатор ). Якісно написані звіти сприяють вирішенню проблеми.

Звіти про помилки потрібно писати англійською мовою. Якщо ви не володієте англійською, скористайтеся інструментом машинного перекладу на зразок Google Translate.

Короткі рекомендації щодо звітів

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

Перед тим, як щось зробити

Чи можете ви відтворити проблему?

Спробуйте відтворити знайдену помилку на останній версії програмного забезпечення, щоб побачити, чи її ще не виправили. Якщо помилка присутня на вікісайті, наприклад, Вікіпедії, то свіжу версію програмного забезпечення Ви можете протестувати на test2.wikipedia.org.

Чи хтось інший вже повідомляв про цю проблему?

Скористайтеся полем пошуку на баґ-трекері Вікімедіа, щоб впевнитися, що про Вашу проблему ще немає звіту. Також Ви можете виконати розширений пошук на сторінці розширеного пошуку.

Якщо ви не впевенені, чи про баґ уже повідомили, вам варто все одно про нього написати. Краще мати повідомлення-дублікати, ніж баґи, про які не було звітів.

Може це проблема з додатком чи користувацьким скриптом?

Деякі проблеми є наслідком використання користувацьких скриптів та додатків, які потребують виправлень. Є посібник із розписаними кроками для визначення того коду, який може виправили вашу проблему, щоб вам не треба було витрачати час на звіт про неї.

Звіт про нову помилку або запит на функцію

Якщо ви зіткнулися з помилкою в останній версії і ще ніхто про неї не повідомив, то:

  1. Перейдіть на phabricator.wikimedia.org.
  2. Вас попросять увійти (або зареєструватися), якщо Ви цього не зробили (див. «Створення облікового запису »).
  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.
    • Оберіть теги (проекти), у яких Ви знайшли помилку:
      • Проекти — це спосіб, у який розробники знаходять завдання для роботи. Щоб визначити правильні проекти, скористайтеся функцією пошуку (угорі справа), щоб знайти їх описи.
      • Це може бути, наприклад, проект MediaWiki-General-or-Unknown для самого програмного забезпечення wiki або Wikimedia-Site-Requests для зміни конфігурації на веб-сайті Wikimedia (див. Selecting projects ).
    • Підписані (поставити на копію): Якщо Ви знаєте конкретних користувачів, які зацікавляться цим питанням, можете додати їх тут. В іншому разі, проігноруйте це поле.

Перевірте, що Ваш звіт завершений, тоді натисніть кнопку «Create Task» (Створити завдання). Ваш звіт тепер буде у базі даних. Завдяки цьому зацікавлена у відгуку людина зможе на нього подивитися і потенційно взяти в роботу .

Пріоритет для завдання встановлять розробники, якщо вони збираються працювати над завданням (див. Вказання пріоритетів).

Готово! Дякуємо за вашу допомогу у покращенні MediaWiki та проектів Вікімедіа!

Повідомлення про помилку JavaScript bug

Див. також: Довідка:Виявлення зламаних скриптів

Чимало функціоналу, такого як додатки, користувацькі скрипти та деякі частини MediaWiki, використовують JavaScript.

Якщо Ви зіткнулися з проблемою, що може бути пов'язана з JavaScript, зробіть усе можливе, щоб знайти повідомлення помилки і скопіювати їх у звіт про помилку.

Дуже важливо надати усю інформацію, яку Ви маєте, бо навіть системні адміністратори не матимуть ніякого доступу до жодного журналу помилок.

Якщо проблема у коді самого користувацького скрипта чи додатка, тоді, можливо, Фабрикатор — не те місце, де проблема вирішиться.[1] Хтось може перенаправити вас на сторінку обговорення скрипта (якщо визначено конкретний скрипт, який породжує проблему).

Повідомлення про проблему зв'язку

Якщо у вас є проблеми з узагалі доступом до вебсайту Вікімедіа (повільне інтернет-з'єднання абощо), будь ласка, слідуйте рекомендаціям на сторінці wikitech:Reporting a connectivity issue.

Повідомлення про проблему входу в систему

Якщо у вас виникли проблеми з входом у свій обліковий запис, будь ласка, слідуйте цій інструкції: Manual:How to debug/Login problems.

Нотатки

Див. також