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) * CC (поставити на копію): Це поле слід проігнорувати; якщо ж Ви знаєте конкретних користувачів, які зацікавляться цим питанням, можете додати їх тут.
 * 10) * Priority: Це поле слід проігнорувати; загалом, пріоритет встановлюють розробники, які збираються працювати над завданням (див. Вказання пріоритетів).
 * 11) * Оберіть проекти(и), де Ви знайшли помилку:
 * 12) **Проекти — це спосіб, у який розробники знаходять завдання для роботи. Щоб визначити правильні проекти, скористайтеся функцією пошуку (угорі справа), щоб знайти їх описи.
 * 13) **Це може бути, наприклад, проект для самого програмного забезпечення вікі або  для змін конфігурації на сайті Вікімедіа (див. «»).
 * 14) * Security: Set this to "Security or Sensitive bug" if many users could be harmed by the security problem that you are reporting. Your report will be kept hidden from the public until it is resolved.
 * 15) * Description (опис): Повний опис проблеми, з поданням усіх деталей, які тільки можна. Це можуть бути:
 * 16) ** Для помилок:
 * 17) *** Steps to Reproduce (кроки відтворення): Коротка послідовність кроків, що призводить до появи описуваної проблеми. Включаючи всі налаштування.
 * Приклад:
 * 1) *** Actual Results (фактичні результати): Що робить програма після виконання вищеописаних кроків.
 * Приклад:
 * 1) ***Expected Results (очікувані результати): Що програма мала б виконати, якби не було помилки.
 * Приклад:
 * 1) ** Для зручності запитів:
 * 2) *** A description of what you would like to achieve, and why. A user story is an effective way of conveying this.
 * Приклад:
 * 1) **Будь ласка, надайте також будь-яку іншу інформацію, що може бути корисною, таку як:
 * 2) ***веб-браузери, стилі оформленні чи операційні системи, на яких ви спостерігаєте помилку;
 * 3) ***посилання на одну чи більше сторінок, на яких ви виявили помилку, різниці версій або
 * 4) ***чи з'являється проблема кожного разу, час від часу, лише на певних сторінках чи лише за певних умов.
 * 5) *To attach a log file or (but make sure that no confidential data is included or shown), click the Upload File button (a cloud with an arrow) in the tool bar of the Description field.
 * 1) *** A description of what you would like to achieve, and why. A user story is an effective way of conveying this.
 * Приклад:
 * 1) **Будь ласка, надайте також будь-яку іншу інформацію, що може бути корисною, таку як:
 * 2) ***веб-браузери, стилі оформленні чи операційні системи, на яких ви спостерігаєте помилку;
 * 3) ***посилання на одну чи більше сторінок, на яких ви виявили помилку, різниці версій або
 * 4) ***чи з'являється проблема кожного разу, час від часу, лише на певних сторінках чи лише за певних умов.
 * 5) *To attach a log file or (but make sure that no confidential data is included or shown), click the Upload File button (a cloud with an arrow) in the tool bar of the Description field.
 * 1) *To attach a log file or (but make sure that no confidential data is included or shown), click the Upload File button (a cloud with an arrow) in the tool bar of the Description field.

Check if your report is complete, then press the "Create Task" button. Your report will now be in the database and somebody will hopefully take a look at it soon.

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

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

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

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

Див. також

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