How to report a bug/uk

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



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

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



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


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



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

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



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



Звіт про нову помилку або запит на функцію
Якщо ви зіткнулися з помилкою в останній версії і ще ніхто про неї не повідомив, то:
 * 1) Перейдіть на phabricator.wikimedia.org.
 * 2) Вас попросять увійти (або зареєструватися), якщо Ви цього не зробили (див. «»).
 * 3) Натисніть на кнопку «Закладка» у правому верхньому кутку і виберіть «Створити завдання» (або «Повідомити про проблему безпеки», щоб ).
 * 4) Заповніть хоча б наступні поля:
 * 5) * Title (заголовок): Короткий опис, що характеризує проблему одним реченням (а не вирішення, яке Ви пропонуєте).
 * 6) ** Добре:
 * 7) ** Погано:
 * 8) * Description (опис): Повний опис проблеми, що містить всі подробиці, наразі вам відомі. If that is insufficient you will be asked for additional information along with guidance on how to obtain it. Це поле має включати:
 * 9) ** Для помилок:
 * 10) *** Steps to Reproduce (кроки відтворення): Коротка послідовність кроків, що призводить до появи описуваної проблеми. Включаючи всі налаштування.
 * Приклад:
 * 1) *** Actual Results (фактичні результати): Що робить програма після виконання вищеописаних кроків.
 * Приклад:
 * 1) *** Expected Results (очікувані результати): Що програма мала б виконати, якби не було помилки.
 * Приклад:
 * 1) ** Для зручності запитів:
 * 2) *** Опис того, що Ви хочете отримати і чому. Поясність, що, на вашу думку, функція має вирішити (власне, вихідну проблему), додавши конкретні приклади; але не вимагайте конкретного рішення, бо ж можуть існувати інші/кращі рішення. Розповідь користувача — ефективний спосіб це передати.
 * Приклад:
 * 1) ** Будь ласка, надайте також будь-яку іншу інформацію, що може бути корисною, таку як:
 * 2) *** веб-браузери, стилі оформленні чи операційні системи, на яких ви спостерігаєте помилку;
 * 3) *** посилання на одну чи більше сторінок, на яких ви виявили помилку, різниці версій або
 * 4) *** чи з'являється проблема кожного разу, час від часу, лише на певних сторінках чи лише за певних умов.
 * 5) * Щоб прикріпити файл журналу або (але спершу переконайтеся, що там немає ніяких конфіденційних даних), натисніть кнопку Upload File (хмарка зі стрілкою) на панелі інструментів у полі Description.
 * 6) * Оберіть теги (проєкти), у яких Ви знайшли помилку:
 * 7) ** Проєкти — це спосіб, у який розробники знаходять завдання для роботи. Щоб визначити правильні проєкти, скористайтеся функцією пошуку (угорі справа), щоб знайти їх описи.
 * 8) ** Це може бути, наприклад, проєкт для самого програмного забезпечення вікі або  для зміни конфігурації на веб-сайті Вікімедіа (див. ).
 * 9) * Підписані (поставити на копію): Якщо Ви знаєте конкретних користувачів, які зацікавляться цим питанням, можете додати їх тут. В іншому разі, проігноруйте це поле.
 * 1) *** веб-браузери, стилі оформленні чи операційні системи, на яких ви спостерігаєте помилку;
 * 2) *** посилання на одну чи більше сторінок, на яких ви виявили помилку, різниці версій або
 * 3) *** чи з'являється проблема кожного разу, час від часу, лише на певних сторінках чи лише за певних умов.
 * 4) * Щоб прикріпити файл журналу або (але спершу переконайтеся, що там немає ніяких конфіденційних даних), натисніть кнопку Upload File (хмарка зі стрілкою) на панелі інструментів у полі Description.
 * 5) * Оберіть теги (проєкти), у яких Ви знайшли помилку:
 * 6) ** Проєкти — це спосіб, у який розробники знаходять завдання для роботи. Щоб визначити правильні проєкти, скористайтеся функцією пошуку (угорі справа), щоб знайти їх описи.
 * 7) ** Це може бути, наприклад, проєкт для самого програмного забезпечення вікі або  для зміни конфігурації на веб-сайті Вікімедіа (див. ).
 * 8) * Підписані (поставити на копію): Якщо Ви знаєте конкретних користувачів, які зацікавляться цим питанням, можете додати їх тут. В іншому разі, проігноруйте це поле.

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

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

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



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

 * Див. також: 

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

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

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

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



Повідомлення про проблему зв'язку
Якщо у вас є проблеми з узагалі доступом до вебсайту Вікімедіа (повільне інтернет-з'єднання абощо), будь ласка, слідуйте рекомендаціям на сторінці https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue



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

Нотатки


Див. також

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