Доклады по программным ошибкам и проблемам

From Joomla! Documentation

This page is a translated version of the page Filing bugs and issues and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎català • ‎eesti • ‎español • ‎français • ‎italiano • ‎português • ‎svenska • ‎Ελληνικά • ‎русский • ‎অসমীয়া • ‎中文(台灣)‎ • ‎日本語

Чтобы сообщить о какой-либо программной ошибке на тракер программных ошибок Joomla!, Вам необходимо создать некоторый тракерный пункт. Как только этот тракерный пункт создан, определенный разработчик проверит его действительность и отреагирует соответствующим образом. Если Вы желаете помочь в тестировании патчей системы Joomla!, то выполните, пожалуйста, эти подробные инструкции.

Сообщить о программных ошибках

Зарегистрируйте аккаунт на GitHub

Вам будет необходимо зарегистрировать свой аккаунт на GitHub; тракер "Joomla! Issue Tracker" использует для входа аккаунты на GitHub.

Войдите в тракер багов Joomla!

Проверьте, была ли эта программная ошибка, о которой Вы собираетесь доложить, уже отправлена ранее на тракер.

Элементы трекера отображаются с помощью ряда фильтров, доступ к которым можно получить, нажав кнопку «Инструменты поиска» в верхней части списка. Если о проблеме, с которой вы столкнулись, еще не сообщалось, нажмите кнопку «Новый элемент» в основной области навигации.

Будет показан новый экран. Чем больше информации Вы представите, тем легче будет [работать] разработчикам [над ее устранением].

Предоставьте как можно больше информации. Щелкая на переключатель "Режим просмотра" в правой части экрана с "Pro" на "Помощь" Для каждого поля Вы можете включить подсказки для каждого поля.

  • Приоритет : Используйте [приоритет] по умолчанию "Средний", за исключением [случаев], где Вы достаточно хорошо знакомы с кодом, чтобы [оправдать] выбор другого [приоритета].
  • Билд: введите здесь версию(ии), [на которую(ые)] распространяется данная проблема.
  • Категории: здесь более сложно. Используйте "Administration", если Вы не можете предложить лучший [выбор].
  • Название: краткое изложение данной проблемы.
  • Описание: подробно о данной ошибке. Для подробных указаний познакомтесь, пожалуйста, с ниже расположенным разделом.
  • Загрузка: пользователям разрешается вместе с докладами об ошибках загружать изображения. Информация по требованиям к загрузке приведена на веб-форме доклада.

Предоставьте краткое изложение этой программной ошибки

Опишите в нескольких словах обнаруженную Вами проблему. Если это Ваш первый доклад на тракер о [найденной] програмной ошибке, то в общем будет неплохой идеей воспользоваться уже существующими на тракере записями в качестве примера.

Примеры:

  • Лицевая часть: такое-то и такое-то предупреждение.
  • Административная часть: после публикации плагина "названиеплагина" не удается сохранить материалы.

Примечание: уделите [должное] внимание [созданию] своего краткого изложения [обнаруженной програмной ошибки], поскольку она будет первым, что увидят разработчики, гоняющиеся на тракере за отладкой ошибок.

Предоставьте подробную информацию о данной программной ошибке

Чтобы получить наиболее полную информацию, тракер заполняет поле описания шаблоном с пятью под-разделами:

  • Шаги для воспроизведения этой проблемы: подробные пошаговые [указания] о [том], как другой человек сможет воспроизвести эту ошибку.
  • Ожидаемый результат: что по-Вашему должно произойти, как только будут выполнены выше указанные [пошаговые] инструкции.
  • Фактический результат: что фактически произошло как только были выполнены выше указанные пошаговые [указания].
  • Информация по системе: информация по конфигурации Вашей системной среды. Сюда входит какой браузер Вы используете, версия PHP Вашего сервера или тип используемой на Вашем веб-сайте базы данных. Для наиболее оптимального результата Вы можете скопировать данные, войдя в административный раздел [по навигационному пути] "Система" -> "Информация о системе".
  • Дополнительные комментарии: любая не предоставленная выше информация, которая может быть полезна для поиска этой неисправности и ее устранения.

Общий формат должен быть примерно таким:

  1. "Вот в точности что я проделал."
  2. "Вот что произошло."
  3. "Вот что по-моему должно было произойти."
  4. "Другая информация, возможное решение, предложенный патч [с] кодом."

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

Пример А

Что я сделал
начал на демонстрационном веб-сайте. Все было в порядке. Я включил [плагин] "названиеплагина". Попытайтесь сохранить какой-либо материал в административной панели.
Что произошло
я получил былый экран и материал не был сохранен.
Что должно было произойти
материалы должны сохраняться правильно.
Прочие данные
это какие плагины включены одновременно. SEF включен (или выключен). Мой веб-сайт находится в такой-то под-директории. Я также отмечаю, что .... По-моему, такой-то и такой-то файл являются [источником] проблемы (если Вы знаете о чем Вы говорите).

Пример Б

Что я сделал
прошел в административную панель. Щелкнул на пункт меню "название_пункта_меню".
Что получилось
страница открылась как белый экран.
Что должно было получиться
меню должно было открыть [страницу] правильно.
Дополнительная информация
любые другие меню работают в порядке.

Примеры из практики

  • Что я сделал
  1. Начал на веб-сайте с демонстрационными [данными].
  2. Добавил [находясь в] административной панели неопубликованный материал в категории FAQ, под-категории "General".
  3. Во вкладке расширенных параметров отображения материала установите "Заголовок" на "Скрыть" и "Иконка печати" и "Иконка электронной почты" на "Скрыть".
  4. Сохраните этот материал и пройдите на лицевую часть [веб-сайта]. Войдите в лицевую часть как администрато и пройдите на пункт меню "Example Pages" -> "Category Blog".
  • Что произошло: только что созданный материал показан на [его] лицевой части [веб-сайта] , но [на его веб-странице] нет иконки "Изменить" [для редактирования этого материла с лицевой части].
  • Что должно было произойти: иконка "Изменить" должна была показаться, позволяя пользователю лицевой части [щелкнуть на нее] чтобы отредактировать этот материал.
  • Прочая информация: это происходит только с шаблоном "protostar". Изменяя следующий код [предлагаемый код] в файле [название и путь к данному файлу], строка(и) номер ..., данная проблема в моих настройках исчезла.

Создать "pull" запрос непосредственно в Joomla-вском репозитории на GitHub

Если Вы желаете предложить какое-либо исправление, предоставляя код для самой системы Joomla, то Вы можете сделать это создав запрос "pull" в репозитории кода Joomla на GitHub.com, расположенного здесь: https://github.com/joomla/joomla-cms

Этот процесс требует некоторого опыта в отношении систем управления исходным кодом, конкретно - системы Git. Если Вы знаете что такое 'Git SCM' и как она работает, то этот процесс [будет для Вас] прост.:

  • Зарегистрируйтесь на бесплатный аккаунта на GitHub.com.
  • Ответвите репозиторий Joomla
  • Переключитесь на ветку «staging», если вы хотите предложить исправление для текущего релиза Joomla! 3.x, или на другую ветку, если вы хотите предложить исправление для следующей версии Joomla!
  • Добавьте/обновите соответствующие файлы системы Joomla в правой ветке и затем щелкните на кнопку "review & compare" ("просмотреть и сравнить") - больше об этом на https://help.github.com/articles/using-pull-requests (англ) - начать процесс создания запроса на "pull".

Дополнительные подсказки и трюки

Хорошо написанные доклады об ошибках [являются] существенной помощью. Однако, с работой любой системы тракинга программных ошибок связаны расходы ресурсов, так что Ваша помощь в [том, чтобы] содержать наш трекет как можно [более] полезным, [будет принята с] признательностью. Особенно:

  • Обязательно прочитайте раздел FAQ чтобы проверить, не является ли Ваша проблема [уже] хорошо известным вопросом.
  • Проведите поиск на тракере чтобы проверить, не была ли Ваша проблема уже отправлена на него.
  • Если Вы не уверены в том, является ли то, что Вы обнаружили, программной ошибкой, то обязательно задайте вопрос о том как отправлять доклады о программных ошибках на форуме Joomla 3.x f.
  • Обязательно пишите полные, конкретные и с четкими указаниями [по воспроизведению данной ошибки] доклады. Включайте как можно больше информации, дополняя ее отрывками кода, пользовательскими сценариями и так далее. Самый лучший доклад о программной ошибке - это минимальный пример, который иллюстрирует конкретную программную ошибку в небольшом пользовательском сценарии.
  • Не используйте систему трекеров, чтобы задавать вопросы в службу поддержки. Используйте для этого форумы Joomla!.
  • Не используйте трекеры для масштабных запросов о возможностях. Мы предпочитаем обсуждать любые крупные изменения в ядре Joomla! на форумах для разработчиков, прежде чем приступать к работе над ними.
  • Не открывайте заново проблемы, которые были помечены как «решение в ожидании». Эта пометка означает, что принято решение о том, что мы не можем или не будем исправлять эту конкретную проблему. Если вы не знаете, почему, спросите об этом на форумедля разработчиков.
  • Не используйте трекер для длинных обсуждений, потому что они могут быть потеряны. Если какой-то пункт трекера вызывает споры, перенесите его обсуждение в форумах для разработчиков.

Доклад проблем с безопасностью

Докладывайте о проблемах с безопасностью по [адресу электронной почты] security [at] joomla [dot] org. Этот приватный почтовый список открыт только давно работающим и доверенным разработчикам [системы] Joomla! и его архивы закрыты от публичного чтения.

В случае какой-либо подтвержденной уязвимости самой [системы] Joomla, мы примем следующие меры:

  • Подтвердим доложившему получение данного доклада и будущее исправление. Мы предоставим приблизительный срок времени и попросим доложившего сохранять данную проблему конфиденциально до тех пор, пока мы не объявим о ней.
  • Остановим другие разработки на столько [времени], сколько нужно для разработки какого-либо исправления, включая патчи для текущего и двух предыдущих выпусков.
  • Определим дату публичного объявления о данной уязвимости и ее устранении. В целях сведения к минимуму возможную "гонку вооружений" между теми, кто применяет данный патч и теми, кто пытается злоупотреблять данной уязвимостью, мы не будем объявлять о проблемах с безопасностью немедленно.
  • Публично объявим о данной уязвимости и [ее] устранении согласно предварительно назначенной [для этого] даты. Наиболее вероятно это будет означать новый выпуск [системы] Joomla, но в некоторых случаях это возможно будет просто патч для текущего выпуска.