Bugzilla/Bug report guide/ru

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

Основная информация
Перечитайте текст отчета перед отправкой; изменения нельзя отменить и текст нельзя отредактировать впоследствии. Текст отчета об ошибке, как правило, немедленно отправляется по электронной почте большому количеству людей.

Создание нового отчета об ошибке (bug)
Поищите дубликаты — возможно, кто-то уже отправил отчет с вашей проблемой. Создание нового отчета об ошибке сопровождается инструкциями, которые следует внимательно прочитать. При выборе категории отображается список недавно добавленных отчетов, в целях избежания дубликатов.

Добавление информации в другой bug

 * Не отклоняйтесь от темы. — Bug tracker предназначен для технических отчетов, а не для разговоров. Для этого существует форум, IRC и списки рассылок.
 * Подтверждайте существование проблемы только один раз. — Если вы и кто-то другой сообщите дважды о той же самой проблеме, это не поспособствует ее решению. Однако, если ваша система очевидно отличается от системы подтвердившего ошибку, и это имеет значение, тогда добавьте эту информацию.
 * Не захватывайте другие отчеты. — Если ваша проблема не обсуждается в отчете, поищите отчет, имеющий к ней отношение или создайте новый.
 * Никаких разговоров в tracker bugs. — Эти отчеты являются мета-отчетами. Если вы хотите добавить полезную информацию, добавьте ее в подходящий суб-отчет или создайте новый отчет.

Packages/ebuild
Вы должны всегда добавлять информацию о системной конфигурации в баг. Для этого создайте новое вложение (attachment) и вставьте содержимое:

Проблемы во время сборки
Полезные файлы и информация упорядоченные по приоритету:


 * Точная версия пакета в заголовке отчета, например sys-apps/package-2.3-r4
 * По возможности, добавьте к заголовку фрагменты сообщения об ошибке
 * Файл журнала в
 * Если файл журнала слишком велик для загрузки, сожмите его: и загрузите build.log.xz из этого каталога
 * Вывод команды emerge --info 

Проблемы во время выполнения
Файлы и информация, представляющая интерес, в порядке приоритета:


 * Точная версия пакета в заголовке отчета, например sys-apps/package-2.3-r4 аварийно завершается с ошибкой: Не могу продолжать...
 * Описание проблемы, чтобы другие могли ее воспроизвести:
 * Как запускается программа (в консоли, в терминале, в качестве демона, в каком уровне запуска и так далее)
 * Какие ошибки выводятся
 * Что заставляет программу аварийно завершаться, неправильно работать, не запускаться
 * Есть ли возможность обойти проблему?
 * Последняя версия пакета, которая работала нормально, если таковая была
 * Какие изменения привели к тому, что программа перестала работать?
 * Вывод команды emerge --info
 * Вывод команды emerge -pv  для быстрого просмотра зависимостей

Для пакета XY выпущена новая версия
Вэб-сайт разработчика сообщил о том, что доступен новый релиз:


 * Подождите 24 часа с момента объявления о релизе. Возможно, разработчик уже работает над этой проблемой.
 * Включите в отчет ссылку на веб-сайт разработчиков
 * Включите в отчет ссылку или список исправленных ошибок или новых возможностей

При предоставлении новой информации для обновленного файла ebuild (необязательно):


 * Если новая версия не требует изменения содержимого файла ebuild, отметьте это
 * Протестируйте файл ebuild в локальном оверлее перед тем как прикрепить и отправить его
 * Предоставьте патчи для предложенных изменений файла ebuild, по желанию, с объяснением изменений (имя файла должно соответствовать новому номеру версии, не старому)
 * Предоставьте дополнительные файлы (initd, unit-файлы) в качестве отдельных прикреплений (по необходимости)
 * Не вставляйте файлы ebuild или другое содержимое, относящееся к ним, прямо в комментарии; используйте прикрепления

Пакет XY должен быть в Portage
Если вы хотите добавить в Portage новый ebuild для какой-либо программы, вам нужно найти куратора (maintainer) для пакета, либо самому им стать:


 * Включите в отчет ссылку на веб-сайт разработчиков
 * Включите в отчет ссылку или список возможностей программы
 * Предоставьте файл ebuild и патчи, оттестированные в локальном оверлее (помощь в этом можно получить на IRC или на форуме)

Пакет XY следует отметить как стабильный
Пакет собирается и работает без проблем более 30 дней, но все еще отмечен как нестабильный:


 * Более подробную информацию о стабильной/нестабильной ветвях можно найти в статье KEYWORDS
 * Вы тщательно оттестировали версию, которую вы хотите сделать стабильной?
 * Существуют другие отчеты, относящиеся к этой ошибке?
 * Версия пакета была добавлена как минимум 30 дней назад?
 * Все зависимости этой версии отмечены, как стабильные?

Ядро
Файлы и информация, представляющая интерес для отчетов об ошибках ядра, в порядке приоритета:


 * Какая версия ядра используется, на какой архитектуре, например gentoo-sources-3.4.2-r2 на x86_64
 * Файл конфигурации ядра следует прикрепить к отчету:
 * Список всех устройств в системе можно получить с помощью команды lspci -k
 * Следует прикрепить файлы журналов ядра, содержащие информацию о его инициализации: или

Другие отчеты об ошибках
Тут нет шаблонов, это относится к категории проблем вроде тех, которые возникают с captcha на wiki.gentoo.org, forum.gentoo.org недоступен, или к любым другим проблемам, не относящимся к программному обеспечению.

Смотрите также

 * Bugzilla guide
 * Contributing to Gentoo
 * Stable request
 * Gentoo Github - Helping the Gentoo project and considering sending a Pull Request via GitHub

Внешние ресурсы

 * Сайт Gentoo Bugzilla