Bugzilla/Bug report guide/ru

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

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

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

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

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

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

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


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

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


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

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


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

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


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

Пакет XY должен быть в Portage
If you request a new ebuild for a software to be added to portage, you must find or become a maintainer for the package:


 * Link to the upstream website in the bug report
 * Give a link or list of features
 * Provide an ebuild and patches that were tested in the local overlay (you can get help in IRC or in the forums with that)

Package XY should be marked stable
A package is building and working without problems on the system for more than 30 days but is still marked as unstable:


 * See KEYWORDS for more information on stable/unstable branch
 * Did you test the version you want to become stable thoroughly?
 * Are there other bug reports regarding this bug?
 * Was the version of the package added to the tree at least 30 days ago?
 * Are its dependencies all marked stable?

Ядро
Files and information of interest for kernel bug reports ordered by priority:


 * Which kernel and version is used, on what architecture e.g. gentoo-sources-3.4.2-r2 on x86_64
 * The kernel configuration file should be attached to the bug report
 * A list of all devices in the system can be acquired with lspci -k
 * Log files during kernel initialization should be attached or

Other bug reports
There is no real template, this falls under the category like problems with captcha on wiki.gentoo.org, forum.gentoo.org is down or anything else that is not really related to software.

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

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

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

 * Сайт Gentoo Bugzilla