Bugzilla/Bug report guide/ru

Лучшие практики

 * Перечитайте текст отчета перед отправкой; текст нельзя отредактировать впоследствии. Текст отчета об ошибке, как правило, немедленно отправляется по электронной почте множеству людей. Напишите отчет ясно, на чистом языке; избегайте разговорной лексики. Подсказка: Представьте, что у вас есть только один шанс в вашей жизни, чтобы написать этот очень важный отчет об ошибке. Вы должны понимать, что получатель может прочитать по-английски, но это может быть не его родной язык.


 * Поищите дубликаты, перед созданием нового бага.


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

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

Сообщите об ошибке во время сборки (emerge failed)

 * Сперва напишите точную версию пакета в заголовке отчета, например sys-apps/package-2.3-r4
 * Добавьте в заголовок краткое сообщение ошибки
 * Прикрепите (attach) логи к сообщению об ошибке

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

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

Сообщить о новой версии; новая версия программы доступна какое-то время

 * Выполните поиск в Bugzilla перед тем, как отправлять запрос на новую версию – существует ли открытый баг? Было ли недавно обновлено локальное дерево Portage; присутствует ли новая версия в Portage?
 * Избегайте запросов новых версий после нулевого дня с выпуска релиза (подождите по крайней мере 48 часов после сообщения о выпуске)
 * Была ли новая версия действительно выпущена разработчиками, или она только отмечена в дереве исходных кодов? В некоторых проектах новую версию в дереве отмечают задолго до официального выпуска.
 * Обязательно отметьте, если новая версия компилируется и хорошо работает на вашей архитектуре. Любая другая полезная информация, которую вы предоставите, весьма приветствуется.
 * Добавьте ссылку на web-сайт проекта.
 * Предоставьте список исправленных ошибок и новых возможностей (иногда называемый changelog) или ссылку на него
 * Запишите заголовок в формате app-editors/vim-12.3.5 version bump

Не обязательно

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

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


 * Включите в отчет ссылку на веб-сайт разработчиков
 * Включите в отчет ссылку или список возможностей программы
 * Укажите предварительную категорию и имя пакета для ebuild в строке темы, например «media-gfx/inkscape ebuild request»
 * Предоставьте файл ebuild и патчи, оттестированные в локальном оверлее (помощь в этом можно получить на IRC или на форумах)

If no bug report exists for the package, you can file a bug report under the Gentoo Linux project and the component New package.

The Summary of your bug report should list a (preliminary) package atom category/package, perhaps with a -VERSION suffix, followed by a canonical short description of the package (the DESCRIPTION variable in an ebuild). It is important to disambiguate the name of the new package: if upstream uses different names for the same software, perhaps an abbreviation as well as the full name, you should mention both (all) of these in the Summary so that other people can find bug reports about the same software. If several (groups of) people track different bug reports about virtually the same ebuild request, this will duplicate the effort of ebuild research and development, and will divide people who have a common interest.

You should link to the upstream website (the HOMEPAGE variable in an ebuild) using the URL field. You should provide a list of features in the Description of the bug report. This may well be taken directly from the upstream website or from a manual or other documentation, and could be used later for the longdescription tag in metadata.xml.

You can attach an ebuild and related files that should go into the portage tree directly to the bug report, or you can use the See also field to refer to a git pull request.

You can help develop the package by setting up a local overlay with your ebuilds, metadata, patches and other auxiliary files. If you need technical support with your ebuild development, many people would be glad to help.

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

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


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

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

 * Веб-сайт Gentoo Bugzilla
 * Веб-сайт Gentoo Bugzilla
 * Веб-сайт Gentoo Bugzilla
 * Веб-сайт Gentoo Bugzilla