Bugzilla/Bug report guide/ru

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

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

 * Reread the text before submission, the text cannot be edited afterwards. Also any text entered into a bug report will be usually e-mailed immediately to many people. Write in precise and clean language and avoid colloquial speech. Hint: Imagine you have only one chance in your life to write this very important bug report. You know that the recipient can read English, but it is not his native language.


 * Search for duplicates, before creating a new bug.


 * Stay on topic - A bug ticket is used for technical reports and chitchat should be avoided. Keep them in the support channels (forums, IRC or mailing-lists).
 * Confirm the existence of a problem only once. - It does not help solving the problem, if you and another person report it twice. But if your and the confirmer's systems differ in an obvious way and that would be helpful to know, add this information.
 * Open one bug ticket per topic - If your problem is not discussed on a bug, search for one related to your issue or create a new report. Do not hijack bugs.
 * No talk on TRACKER bugs. - Those bugs are meta bugs. If you want to add useful information, add them to a related sub bug or create a new bug.

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) и вставьте содержимое:

Report a build-time bug (emerge failed)

 * First write the exact version of the package in the title of the bug report e.g. sys-apps/package-2.3-r4
 * Add a short description to the title.
 * Attach the logfile in
 * If your logfile is too big to upload, compress it: and upload the build.log.xz
 * Attach the output of

Report a run-time bug
Файлы и информация, представляющая интерес, в порядке приоритета:


 * The exact version of the package in the title of the bug report e.g. sys-apps/package-2.3-r4 crashes with error: Cannot proceed...
 * Description of the problem, so that other can reproduce it:
 * How is the program run (on the console, in a terminal, as a daemon, in what runlevel etc.)
 * Any error output
 * What makes the program crash, behave wrong, not start
 * Is there a workaround?
 * What was the last working version of the package, if any?
 * What changed to make it not work?
 * Attach the output of emerge --info
 * Attach the output of emerge -pv  to quickly see what are the dependencies

Report a version bump; a newer upstream release is available since a while

 * 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

Optional

 * 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

Request for a new package; ebuild request
Если вы хотите добавить в Portage новый ebuild для какой-либо программы, вам нужно найти куратора (maintainer) для пакета, либо самому им стать:


 * Link to the upstream website in the bug report
 * Give a link or list of features
 * Suggest a preliminary category and package name for the ebuild in the subject line for example "media-gfx/inkscape ebuild request"
 * Provide an ebuild and patches that were tested in your local overlay (you can get help in IRC or in the forums with that)

Пакет 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