How to report a bug/uk

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

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

 * Будьте точними
 * Висловлюйтесь ясно: поясніть, 1) як відтворити проблему, крок за кроком, точно описаними діями; 2) очікувану поведінку рушія; 3) фактичну його поведінку. В окремих розділах
 * Кожна задача має містити опис лише одної проблеми
 * Додайте всі відповідні посилання й приклади

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

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

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

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

Звіт про нову помилку або запит на функцію
Якщо ви зіткнулися з помилкою в останній версії і ще ніхто про неї не повідомив, то:
 * 1) Перейдіть на phabricator.wikimedia.org.
 * 2) Вас попросять увійти (або зареєструватися), якщо Ви цього не зробили (див. «»).
 * 3) Натисніть на кнопку «Закладка» у правому верхньому кутку і виберіть «Створити завдання» (або «Повідомити про проблему безпеки», щоб ).
 * 4) Заповніть хоча б наступні поля:
 * 5) * Title (заголовок): Короткий опис, що характеризує проблему одним реченням (а не вирішення, яке Ви пропонуєте).
 * 6) ** Добре:
 * 7) ** Погано:
 * 8) * Assigned to (куратор проблеми): Це поле слід проігнорувати; розробники вкажуть куратора, коли будуть планувати роботу над проблемою.
 * 9) * Description (опис): Повний опис проблеми, з поданням усіх деталей, які тільки можна. Це можуть бути:
 * 10) ** Для помилок:
 * 11) *** Steps to Reproduce (кроки відтворення): Коротка послідовність кроків, що призводить до появи описуваної проблеми. Включаючи всі налаштування.
 * Приклад:
 * 1) *** Actual Results (фактичні результати): Що робить програма після виконання вищеописаних кроків.
 * Приклад:
 * 1) *** Expected Results (очікувані результати): Що програма мала б виконати, якби не було помилки.
 * Приклад:
 * 1) ** Для зручності запитів:
 * 2) *** Опис того, що Ви хочете отримати і чому. Поясність, що, на вашу думку, функція має вирішити (власне, вихідну проблему), додавши конкретні приклади; але не вимагайте конкретного рішення, бо ж можуть існувати інші/кращі рішення. Розповідь користувача — ефективний спосіб це передати.
 * Приклад:
 * 1) ** Будь ласка, надайте також будь-яку іншу інформацію, що може бути корисною, таку як:
 * 2) *** веб-браузери, стилі оформленні чи операційні системи, на яких ви спостерігаєте помилку;
 * 3) *** посилання на одну чи більше сторінок, на яких ви виявили помилку, різниці версій або
 * 4) *** чи з'являється проблема кожного разу, час від часу, лише на певних сторінках чи лише за певних умов.
 * 5) * Щоб прикріпити файл журналу або (але спершу переконайтеся, що там немає ніяких конфіденційних даних), натисніть кнопку Upload File (хмарка зі стрілкою) на панелі інструментів у полі Description.
 * 6) * Оберіть теги (проекти), у яких Ви знайшли помилку:
 * 7) ** Проекти — це спосіб, у який розробники знаходять завдання для роботи. Щоб визначити правильні проекти, скористайтеся функцією пошуку (угорі справа), щоб знайти їх описи.
 * 8) ** Це може бути, наприклад, проект для самого програмного забезпечення wiki або  для зміни конфігурації на веб-сайті Wikimedia (див. ).
 * 9) * Підписані (поставити на копію): Якщо Ви знаєте конкретних користувачів, які зацікавляться цим питанням, можете додати їх тут. В іншому разі, проігноруйте це поле.
 * 1) *** веб-браузери, стилі оформленні чи операційні системи, на яких ви спостерігаєте помилку;
 * 2) *** посилання на одну чи більше сторінок, на яких ви виявили помилку, різниці версій або
 * 3) *** чи з'являється проблема кожного разу, час від часу, лише на певних сторінках чи лише за певних умов.
 * 4) * Щоб прикріпити файл журналу або (але спершу переконайтеся, що там немає ніяких конфіденційних даних), натисніть кнопку Upload File (хмарка зі стрілкою) на панелі інструментів у полі Description.
 * 5) * Оберіть теги (проекти), у яких Ви знайшли помилку:
 * 6) ** Проекти — це спосіб, у який розробники знаходять завдання для роботи. Щоб визначити правильні проекти, скористайтеся функцією пошуку (угорі справа), щоб знайти їх описи.
 * 7) ** Це може бути, наприклад, проект для самого програмного забезпечення wiki або  для зміни конфігурації на веб-сайті Wikimedia (див. ).
 * 8) * Підписані (поставити на копію): Якщо Ви знаєте конкретних користувачів, які зацікавляться цим питанням, можете додати їх тут. В іншому разі, проігноруйте це поле.

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

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

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

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

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

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

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

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

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

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

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

Див. також

 * «Як ефективно повідомляти про помилки», автор Simon Tatham
 * Як зробити так, що спільнота розробників вирішила вашу проблему, автор User:MSchottlender-WMF, липень 2017
 * Wikimedia and Етикет Phabricator'а
 * Менеджмент помилок/Життєвий цикл звітів про помилки
 * Написання гарного звіту або запиту на функцію
 * Як створити гарний перший звіт про помилку (застаріло)
 * Звіти про помилки та запити на функції в англомовній Вікіпедії