Bugzilla/Bug report guide/ru

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

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

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


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

Optional: Commercial Gentoo support
If you need commercial support with bugs, any trouble around Gentoo or a new ebuild, have a look on the list of professional Gentoo consultants.

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 выпущена новая версия

 * Search Bugzilla before posting a bump request - is there already a bug open? Has the local Portage tree been synced lately; is it already in Portage?
 * Avoid Zero-day bump requests (wait at least 48 hours after the release announcement)
 * Has it actually been released by upstream sources, or is it just marked in the source tree? Some projects mark a release in the tree long time before it is officially released.
 * Be sure to mention if it compiles and runs well on your arch. Any other helpful information you provide is most welcome.
 * Add a link to the upstream website
 * Give a link or list of fixed bugs or new features (sometimes called changelog)
 * Write a title in the form app-editors/vim-12.3.5 version bump


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


 * Does the ebuild need changes? (changed dependencies, obsolete patch files)
 * Please note, if the new version needs no changes to the ebuild's contents
 * Test the ebuild in a local overlay before submitting attachments
 * Provide patches for proposed ebuild edits, with optional explanation of changes (file name should match the new version number, not old)
 * Provide additional files (initd, unit files) as separate attachments (as needed)
 * Do not paste files directly into comments; use attachments

Пакет 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
 * Как помочь Gentoo
 * Запрос о стабилизации
 * Gentoo Github — Как помочь проекту Gentoo и отправить Pull Request via GitHub

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

 * Сайт Gentoo Bugzilla