How to report a bug/ru

Эти инструкции объясняют, как написать хорошее сообщение об ошибке или запросить новую функцию в багтрекере Фонда Викимедиа (подробнее см. ). Хорошее сообщение об ошибке поможет её исправить.

Краткие рекомендации по написанию сообщений об ошибках

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

Можете ли вы воспроизвести проблему?
Попробуйте воспроизвести свою проблему на последней версии программного обеспечения, чтобы убедиться, что она до сих пор не устранена. Если ошибка присутствует на вики-сайте, например, на Википедии, вы можете попробовать последнюю версию ПО на test2.wikipedia.org.

Кто-нибудь ещё сообщал об этой ошибке?
Используйте форму поиска на багтрекере Викимедиа, чтобы убедиться, что о вашей проблеме ещё не сообщили. Вы также можете провести более глубокий поиск на странице поиска.

Сообщение об ошибке или запрос функции
Если вы встретились с ошибкой в новой версии и ещё никто не сообщал о ней, то:
 * 1) Перейдите на phabricator.wikimedia.org и выберите пункт «Maniphest» в панели навигации.
 * 2) Выберите «maniphest/task/create/ 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) *** Описание того, что вы хотите получить и почему. Пользовательская история (user story) — эффективный способ для такого запроса.
 * Пример:
 * 1) **Пожалуйста, предоставьте также любую дополнительную информацию, которая могла бы быть полезна, такую как:
 * 2) ***веб-браузер, стиль оформления или ОС, в которой вы видите ошибку;
 * 3) ***ссылки на страницы или сравнение версий, в которых вы столкнулись с ошибкой; или
 * 4) ***возникает ли проблема постоянно, или же время от времени, только на некоторых страницах, или в каких-то специфических условиях.
 * 5) *Чтобы приложить к отчёту файл журнала или (предварительно убедившись, что конфиденциальные данные во вложении или скриншоте отсутствуют), нажмите кнопку Upload File (облако со стрелкой) в панели инструментов для поля Description.
 * 6) * Выберите метки (продукт(ы)), где была найдена ошибка:
 * 7) **Проекты — это способ, с помощью которого разработчики находят задачи, над которыми можно работать. Чтобы идентифицировать нужные вам проекты, используйте функцию поиска (справа вверху), чтобы найти описание.
 * 8) **Это может быть, например, для самого ПО вики или, если нужно настроить один из вики-сайтов (см. «»).
 * 9) * Subscribers (подписавшиеся): Вам следует игнорировать это поле. Если же вы знаете пользователей, которые заинтересуются данной проблемой, можете добавить их в это поле.
 * 1) ***веб-браузер, стиль оформления или ОС, в которой вы видите ошибку;
 * 2) ***ссылки на страницы или сравнение версий, в которых вы столкнулись с ошибкой; или
 * 3) ***возникает ли проблема постоянно, или же время от времени, только на некоторых страницах, или в каких-то специфических условиях.
 * 4) *Чтобы приложить к отчёту файл журнала или (предварительно убедившись, что конфиденциальные данные во вложении или скриншоте отсутствуют), нажмите кнопку Upload File (облако со стрелкой) в панели инструментов для поля Description.
 * 5) * Выберите метки (продукт(ы)), где была найдена ошибка:
 * 6) **Проекты — это способ, с помощью которого разработчики находят задачи, над которыми можно работать. Чтобы идентифицировать нужные вам проекты, используйте функцию поиска (справа вверху), чтобы найти описание.
 * 7) **Это может быть, например, для самого ПО вики или, если нужно настроить один из вики-сайтов (см. «»).
 * 8) * Subscribers (подписавшиеся): Вам следует игнорировать это поле. Если же вы знаете пользователей, которые заинтересуются данной проблемой, можете добавить их в это поле.

Убедитесь, что ваш отчёт закончен, затем нажмите кнопку «Create Task» (создать задачу). Ваш отчёт будет помещён в базу данных и кто-нибудь с большой вероятностью в ближайшее время обратит на него внимание.

Готово! Спасибо за то, что помогаете улучшать MediaWiki и проекты Викимедиа!

Сообщить об ошибке в JavaScript
Когда вы обнаруживаете ошибку, которая может быть связана с JavaScript, сделайте всё возможное, чтобы идентифицировать сообщения об ошибках и скопировать их в отчёт об ошибке.

Особенно важно предоставить всю имеющуюся у вас информацию, потому что даже системные администраторы не будут иметь доступа ни к каким журналам ошибок. Если вы не уверены, основана ли на JavaScript возможность, которую вы используете, попробуйте отключить JavaScript.

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

См. также

 * Как эффективно сообщать об ошибках автор Simon Tatham
 * The BugZilla song
 * Википедия: сообщения об ошибках и запрос новых функций (англ.)
 * Этикет Phabricator
 * Управление ошибками/Жизненный цикл отчётов об ошибках
 * Написание хорошего отчёта об ошибке или запроса на введение возможности
 * Как создать хороший первый отчёт об ошибке (устарело)