How to report a bug/uk

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

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

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

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

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

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

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

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

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

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

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

Див. також

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