В этой статье будет рассмотрено оформление различных отчетов.

Содержание

1 Отправка отчетов

Отправка отчетов

Общие действия

Внимание! Прежде чем создавать новый отчет, проверьте, не сообщал ли уже кто-нибудь о вашей ошибке!

Для получения учетной записи в баг-трекере нужно зарегистрироваться на сайте проекта и подождать некоторое время, пока учетная запись ссинхронизируется с баг-трекером.

1.Зайдите на баг-трекер ReactOS: http://jira.reactos.org/

2.Войдите

3.Нажмите «создать запрос»

Оформление отчета

Отправка отчета об ошибке

1.Например, при запуске LinCityNG система выдала ошибку. (PrintScreen виртуальной машины VirtualBox делается так: Машина> Сделать снимок экрана)

2.Выберите тип запроса «Ошибка», и введите тему. В случае примера, «Игра LinCityNG не запускается»

3.В описании напишите, в чем именно заключается ошибка и прикрепите dedug-log, а также, по возможности, скриншот.

Советы по отправке отчетов об ошибке

Первые шаги

Если вам кажется, что вы обнаружили ошибку в ReactOS:

Убедитесь, что используете для тестирования самую последнюю и официальную сборку ReactOS. Свежие сборки (являющиеся предпочтительными для тестирования) можно загрузить здесь.
Убедитесь, что сможете воспроизвести ошибку. Чтобы быть полностью в этом уверенным, перезапустите ReactOS и попытайтесь добиться возникновения этой ошибки ещё раз.
Проверьте, не сообщал ли уже кто-либо об этой ошибке. В этом вам поможет поиск по JIRA.
Если вы запускаете ReactOS на виртуальной машине, пожалуйста, обратите внимание, что нами поддерживаются только QEMU, VMware и VirtualBox. Другие виртуальные машины не поддерживаются.

Поскольку некоторые типы ошибок находятся вне рамок проекта, пожалуйста:

Не сообщайте об ошибках при сборке на общих платформах (Windows, Linux). Сообщите о них на IRC-канале или в списке рассылки Ros-Bug.
Не сообщайте о функциях, которые ожидаются в следующих версиях Windows (WinFS и т.д.).
Не сообщайте об ошибках во внешних компонентах (Freetype, Wine, Mesa, и т.д.). Используйте для этого багтрекеры этих проектов.

Важная информация, которую необходимо включить в отчёт

Для того, чтобы разработчики смогли воспроизвести и исправить ошибку, в вашем отчёте должна присутствовать определенная информация. Важными данными, которые вы должны обязательно добавить в свой отчет, являются:

Способ воспроизведения ошибки с пошаговыми инструкциями.
Аппаратная конфигурация или настройки виртуальной машины.
Версия тестируемого ReactOS (проверьте также, существует ли указанная вами проблема в "ночной сборке").
Версия тестируемого приложения (если имеется) и ссылка для его загрузки (URL).
Скриншот проблемы, если это графические ошибка (добавьте вложение в отчет).
Отчёт с отладочной информацией при критических сбоях, зависаниях и ошибках приложений. Подробнее о том, как правильно снять качественный отчёт вы можете прочитать на странице Отладка.

Руководство по составлению отчетов

Чтобы помочь вам в составлении отчетов и облегчить процесс устранения ошибок, выполните следующие рекомендации:

Выбирайте краткий заголовок для ошибки.
Старайтесь не вставлять отладочные данные непосредственно в сообщение об ошибке, лучше прикрепите его к сообщению. Это способствует удобочитаемости сообщения.
Прикладывайте изображения непросредственно в JIRA, а не с помощью внешнего хостинга.
Используйте JIRA лишь для публикации ошибок, а не для того, чтобы попросить поддержку или обсудить другие вещи, не связанные с ошибкой.
Сообщение об ошибке должно описывать единственную проблему или случай, даже если эта ошибка проявляется в нескольких приложениях или имеет множество способов воспроизведения.
Не описывайте более одной проблемы в одном сообщении об ошибке.

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

В том случае, если у вас возникнут какие-либо вопросы или проблемы, относящиеся к процессу сообщений об ошибках, обратитесь к AmineKhaldi, Caemyr или gabriel_it на IRC-канале.

Дополнительная информация, которую можно добавить

Вы можете предоставить разработчикам более подробную информацию в отчете, заполнив некоторые поля.

Вручную:

Окружение
Тип	Пример
вирт. машина/реальное железо	VirtualBox
объем оперативной памяти	RAM 512mb
объем видеопамяти	videomemory 128mb
ревизия	r65162
дополнительно	installed VirtualBox Additons
Итого:	VirtualBox RAM 512mb videomemory 128mb r65162 installed VirtualBox Additons

Из выпадающего списка:

Компоненты
3D Graphics	Отчет связан с 3D-графикой
Applications
Audio	Отчет связан со звуком
BootLoader	Отчет связан с загрузчиком
BuildSystem	Отчет связан с системой сборки ReactOS
Drivers	Отчет связан с драйверами
Filesystem	Отчет связан с файловыми системами
Networking	Отчет связан с сетью
Setup	Проблемы с установкой
Shell	Отчет связан с оболочкой
Sound	Отчет связан со звуком
USB	Отчет связан с USB

Проявляется в версиях
TRUNK
конкретная версия (0.3.16)

Метки
PATCH	Вы прикладываете патч
REGRESSION	Возникла регрессия (ранее программа работала, сейчас нет)
TRANSLATION	Вы делаете перевод
ntvdm	Отчет связан с DOS-эмулятором ReactOS
shell-experiments	Отчет связан с веткой shell-experiments
rosbe	Отчет связан с системой сборки ReactOS
usb	Проблемы с USB
setup
website	Вопрос по веб-сайту

Модуль
shell32	Отчет связан с Shell32
win32k
ntoskrnl	Отчет связан с ядром
mm	Отчет связан с менеджером памяти
rapps	Отчет связан с менеджером приложений
explorer
kernel32
explorer-new	Отчет связан с новым проводником
ntvdm	Отчет связан с DOS-эмулятором ReactOS
user32
cmd	Отчет связан с командной строкой
ntuser
rtl
regedit	Отчет связан с редактором реестра
uniata	Отчет связан с драйвером UniATA
syssetup
psdk
notepad	Отчет связан с блокнотом
mspaint	Отчет связан с Paint
advapi32

Добавление программы в менеджер приложений

1.Выберите тип запроса «Новая разработка», и введите тему. Например "Programs for the Center of applications ReactOS" или "rapps: add new program"

3.В описании напишите что-нибудь наподобие "Please, add this program in application manager" и добавьте патч. Так же в строке "Метки" введите: patch, а в строке "Module": rapps.

Отправка перевода

Основы перевода и отправку отчета см. здесь.