Как сообщить об ошибке

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page How to report a bug and the translation is 100% complete.

Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Cymraeg • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Kreyòl ayisyen • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Ripoarisch • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎be-tarask • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎hrvatski • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎shqip • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎yue • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎српски / srpski • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎मराठी • ‎हिन्दी • ‎মেইতেই লোন্ • ‎ਪੰਜਾਬੀ • ‎ଓଡ଼ିଆ • ‎தமிழ் • ‎తెలుగు • ‎ಕನ್ನಡ • ‎සිංහල • ‎ไทย • ‎ქართული • ‎ትግርኛ • ‎中文 • ‎日本語 • ‎한국어
shortcut: BUGREPORT

Эти инструкции объясняют, как написать хорошее сообщение об ошибке или запросить новую функцию в трекере задач Wikimedia (подробнее см. Phabricator ). Хорошо написанные задачи с большей вероятностью будут отработаны.

Задачи следует писать на английском языке. Если вы не знаете английского языка, попробуйте использовать инструменты машинного перевода, например Google Translate.

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

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

Перед тем, как вы сделаете что-либо

Можете ли вы воспроизвести проблему?

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

Кто-нибудь ещё сообщал об этой ошибке?

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

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

Сообщение об ошибке или запрос функции

Если вы встретились с ошибкой в новой версии и ещё никто не сообщал о ней, то:

  1. Перейдите на phabricator.wikimedia.org и выберите пункт «Tasks & bugs» в панели навигации.
  2. Выберите «Create task» справа вверху.
  3. Вас попросят авторизоваться (или зарегистрироваться), если вы ещё не сделали этого (см. раздел «Создание учётной записи »).
  4. Заполните следующие поля:
    • Title (краткое описание): Короткое резюме, которое объясняет проблему (а не решение, предлагаемое вами).
      • Хорошо: "Selecting gender is not functional."
      • Плохо: "Software crashes."
    • Assigned to («куратор» проблемы): Вам следует игнорировать данное поле: разработчики установят «куратора», когда будут планировать работу над проблемой.
    • Description (описание): Полное описание проблемы, включающее столько подробностей, сколько возможно. Они могут включать:
      • Для ошибок:
        • Steps to Reproduce (шаги для воспроизведения проблемы): Краткая последовательность несложных для следования шагов, которая вызовет описываемую проблему. Включайте специальные шаги по настройке.
          Пример:
          1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
          2. Make sure you are logged in;
          3. Select "My Preferences" menu;
          4. Go to "Gender" and select female gender from box list;
          5. Click "Save" button.
        • Actual Results (фактические результаты): Реакция приложения на вышеприведённую последовательность действий.
          Пример:
          "There is no female gender in front of my user name."
        • Expected Results (ожидаемые результаты): Что ожидается от приложения, если бы ошибки не было.
          Пример:
          "My gender is shown in front of my user name."
      • Для запросов возможностей:
        • Описание того, что вы хотите получить и почему. Пользовательская история (user story) — эффективный способ для такого запроса.
          Пример:
          "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
      • Пожалуйста, предоставьте также любую дополнительную информацию, которая могла бы быть полезна, такую как:
        • веб-браузер, стиль оформления или ОС, в которой вы видите ошибку;
        • ссылки на страницы или сравнение версий, в которых вы столкнулись с ошибкой; или
        • возникает ли проблема постоянно, или же время от времени, только на некоторых страницах, или в каких-то специфических условиях.
    • Чтобы приложить к отчёту файл журнала или снимок экрана (предварительно убедившись, что конфиденциальные данные во вложении или скриншоте отсутствуют), нажмите кнопку Upload File (облако со стрелкой) в панели инструментов для поля Description.
    • Выберите tags (проект(ы)), где была найдена ошибка:
      • Проекты — это способ, с помощью которого разработчики находят задачи, над которыми можно работать. Чтобы идентифицировать нужные вам проекты, используйте функцию поиска (справа вверху), чтобы найти описание.
      • Это может быть, например, MediaWiki-General-or-Unknown для самого ПО вики или Wikimedia-Site-Requests, если нужно настроить один из вики-сайтов (см. «Выбор проектов »).
    • Subscribers (подписавшиеся): Вам следует игнорировать это поле. Если же вы знаете пользователей, которые заинтересуются данной проблемой, можете добавить их в это поле.

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

Приоритет для задания будет установлен разработчиками, которые планируют работу над проблемой (см. «Задание приоритетов»).

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

Сообщить об ошибке в JavaScript

Смотрите так же: Помощь:Обнаружение нерабочих скриптов

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

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

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

Если проблема вызвана ошибкой в коде самого пользовательского сценария или гаджета, Phabricator вряд ли окажется площадкой, где проблема будет разобрана.[1] Вас могут направить на страницу обсуждения сценария (если вызывающий проблему сценарий будет идентифицирован).

Сообщение об ошибке связи

Если у вас возникли сложности с доступом к сайтам Викимедиа (медленное интернет-соединение и т.п.), пожалуйста, перейдите на страницу с инструкциями о том, как сообщить об ошибке связи.

Сообщение об проблеме со входом в учётную запись

Если вы не можете войти в свою учётную запись, обратитесь к инструкции на странице Manual:How to debug/Login problems.

См. также

  • phab:T85433