Send report — различия между версиями

Материал из Русский WINE
Перейти к: навигация, поиск
(→‎Общие действия)
 
(не показано 12 промежуточных версии этого же участника)
Строка 1: Строка 1:
 
[[Category:ReactOS]]
 
[[Category:ReactOS]]
 
В этой статье будет рассмотрено оформление различных отчетов.
 
В этой статье будет рассмотрено оформление различных отчетов.
−
 
+
=Отправка отчетов=
−
=Общие действия=
+
==Общие действия==
 +
'''Внимание! Прежде чем создавать новый отчет, проверьте, не сообщал ли уже кто-нибудь о вашей ошибке!'''
 +
----
 +
'''Для получения учетной записи в баг-трекере нужно зарегистрироваться на сайте проекта и подождать некоторое время, пока учетная запись ссинхронизируется с баг-трекером.'''
 +
----
 
1.Зайдите на баг-трекер ReactOS: http://jira.reactos.org/
 
1.Зайдите на баг-трекер ReactOS: http://jira.reactos.org/
 
<center>[[Файл:Jira.png|500пкс]]</center>
 
<center>[[Файл:Jira.png|500пкс]]</center>
Строка 11: Строка 15:
 
3.Нажмите «создать запрос»
 
3.Нажмите «создать запрос»
 
<center>[[Файл:Makezap.png|500пкс]]</center>
 
<center>[[Файл:Makezap.png|500пкс]]</center>
−
=Оформление отчета=
+
 
−
==Отправка отчета об ошибке==
+
==Оформление отчета==
 +
===Отправка отчета об ошибке===
 
1.Например, при запуске LinCityNG система выдала ошибку.  
 
1.Например, при запуске LinCityNG система выдала ошибку.  
 
(PrintScreen виртуальной машины VirtualBox делается так: '''''Машина> Сделать снимок экрана''''')
 
(PrintScreen виртуальной машины VirtualBox делается так: '''''Машина> Сделать снимок экрана''''')
Строка 23: Строка 28:
 
3.В описании напишите, в чем именно заключается ошибка и прикрепите dedug-log, а также, по возможности, скриншот.
 
3.В описании напишите, в чем именно заключается ошибка и прикрепите dedug-log, а также, по возможности, скриншот.
 
<center>[[Файл:Makebug2.png|500пкс]]</center>
 
<center>[[Файл:Makebug2.png|500пкс]]</center>
−
*[http://reactosruswiki.zz.mu/index.php?title=%D0%9E%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0_%D0%BE%D1%82%D1%87%D1%91%D1%82%D0%BE%D0%B2_%D0%BE%D0%B1_%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B0%D1%85#.D0.92.D0.B0.D0.B6.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F.2C_.D0.BA.D0.BE.D1.82.D0.BE.D1.80.D1.83.D1.8E_.D0.BD.D0.B5.D0.BE.D0.B1.D1.85.D0.BE.D0.B4.D0.B8.D0.BC.D0.BE_.D0.B2.D0.BA.D0.BB.D1.8E.D1.87.D0.B8.D1.82.D1.8C_.D0.B2_.D0.BE.D1.82.D1.87.D1.91.D1.82 Советы по отправке отчетов об ошибке]
 
  
−
==Добавление программы в менеджер приложений==
+
====Советы по отправке отчетов об ошибке====
 +
 
 +
=====Первые шаги=====
 +
 
 +
Если вам кажется, что вы обнаружили ошибку в ReactOS:
 +
*Убедитесь, что используете для тестирования самую последнюю и официальную сборку ReactOS. Свежие сборки (являющиеся предпочтительными для тестирования) можно загрузить [http://www.reactos.org/getbuilds здесь].
 +
*Убедитесь, что сможете воспроизвести ошибку. Чтобы быть полностью в этом уверенным, перезапустите ReactOS и попытайтесь добиться возникновения этой ошибки ещё раз.
 +
*Проверьте, не сообщал ли уже кто-либо об этой ошибке. В этом вам поможет поиск по JIRA.
 +
*Если вы запускаете ReactOS на виртуальной машине, пожалуйста, обратите внимание, что нами поддерживаются только [[QEMU]], [[VMware]] и [[VirtualBox]]. Другие виртуальные машины не поддерживаются.
 +
 
 +
Поскольку некоторые типы ошибок находятся вне рамок проекта, пожалуйста:
 +
*Не сообщайте об ошибках при сборке на общих платформах (Windows, Linux). Сообщите о них на IRC-канале или в списке рассылки [http://www.reactos.org/?page=community_mailinglists Ros-Bug].
 +
*Не сообщайте о функциях, которые ожидаются в следующих версиях Windows (WinFS и т.д.).
 +
*Не сообщайте об ошибках во внешних компонентах (Freetype, Wine, Mesa, и т.д.). Используйте для этого багтрекеры этих проектов.
 +
 
 +
=====Важная информация, которую необходимо включить в отчёт=====
 +
 
 +
Для того, чтобы разработчики смогли воспроизвести и исправить ошибку, в вашем отчёте должна присутствовать определенная информация. Важными данными, которые вы должны обязательно добавить в свой отчет, являются:
 +
*Способ воспроизведения ошибки с ''пошаговыми'' инструкциями.
 +
*Аппаратная конфигурация или настройки виртуальной машины.
 +
*Версия тестируемого ReactOS (проверьте также, существует ли указанная вами проблема в [http://www.reactos.org/getbuilds/ "ночной сборке"]).
 +
*Версия тестируемого приложения (если имеется) и ссылка для его загрузки (URL).
 +
*Скриншот проблемы, если это графические ошибка (добавьте вложение в отчет).
 +
*Отчёт с отладочной информацией при критических сбоях, зависаниях и ошибках приложений. Подробнее о том, как правильно снять качественный отчёт вы можете прочитать на странице [http://winehq.org.ru/Debugging Отладка].
 +
 
 +
=====Руководство по составлению отчетов=====
 +
 
 +
Чтобы помочь вам в составлении отчетов и облегчить процесс устранения ошибок, выполните следующие рекомендации:
 +
 
 +
*Выбирайте краткий заголовок для ошибки.
 +
*Старайтесь не вставлять отладочные данные непосредственно в сообщение об ошибке, лучше прикрепите его к сообщению. Это способствует удобочитаемости сообщения.
 +
*Прикладывайте изображения непросредственно в JIRA, а не с помощью внешнего хостинга.
 +
*Используйте JIRA лишь для публикации ошибок, а не для того, чтобы попросить поддержку или обсудить другие вещи, не связанные с ошибкой.
 +
*Сообщение об ошибке должно описывать единственную проблему или случай, даже если эта ошибка проявляется в нескольких приложениях или имеет множество способов воспроизведения.
 +
*Не описывайте более одной проблемы в одном сообщении об ошибке.
 +
 
 +
Ошибки, описание которых не соответствует приведенным рекомендациям, будут закрыты как недопустимые, и пользователя, написавшего отчет, попросят сообщить об ошибке должным образом.
 +
 
 +
В том случае, если у вас возникнут какие-либо вопросы или проблемы, относящиеся к процессу сообщений об ошибках, обратитесь к '''AmineKhaldi''', '''Caemyr''' или '''gabriel_it''' на [[IRC]]-канале.
 +
 
 +
====Дополнительная информация, которую можно добавить====
 +
Вы можете предоставить разработчикам более подробную информацию в отчете, заполнив некоторые поля.
 +
 
 +
'''Вручную:'''
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable" style="float:center; margin-left:2em"
 +
!colspan="2" |Окружение
 +
|-
 +
!Тип
 +
!Пример
 +
|-
 +
|вирт. машина/реальное железо
 +
|''VirtualBox''
 +
|-
 +
|объем оперативной памяти
 +
|''RAM 512mb''
 +
|-
 +
|объем видеопамяти
 +
|''videomemory 128mb''
 +
|-
 +
|ревизия
 +
|''r65162''
 +
|-
 +
|дополнительно
 +
| ''installed VirtualBox Additons''
 +
|-
 +
!Итого:
 +
|''VirtualBox RAM 512mb videomemory 128mb r65162 installed VirtualBox Additons''
 +
|-
 +
|}
 +
 
 +
'''Из выпадающего списка:'''
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable" style="float:center; margin-left:2em"
 +
!colspan="2" |Компоненты
 +
|-
 +
|3D Graphics
 +
|Отчет связан с 3D-графикой
 +
|-
 +
|Applications
 +
|
 +
|-
 +
|Audio
 +
|Отчет связан со звуком
 +
|-
 +
|BootLoader
 +
|Отчет связан с загрузчиком
 +
|-
 +
|BuildSystem
 +
|Отчет связан с системой сборки ReactOS
 +
|-
 +
|Drivers
 +
|Отчет связан с драйверами
 +
|-
 +
|Filesystem
 +
|Отчет связан с файловыми системами
 +
|-
 +
|Networking
 +
|Отчет связан с сетью
 +
|-
 +
|Setup
 +
|Проблемы с установкой
 +
|-
 +
|Shell
 +
|Отчет связан с оболочкой
 +
|-
 +
|Sound
 +
|Отчет связан со звуком
 +
|-
 +
|USB
 +
|Отчет связан с USB
 +
|-
 +
|}
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable" style="float:center; margin-left:2em"
 +
!colspan="2" |Проявляется в версиях
 +
|-
 +
|''TRUNK''
 +
|-
 +
|конкретная версия (''0.3.16'')
 +
|}
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable" style="float:center; margin-left:2em"
 +
!colspan="2" |Метки
 +
|-
 +
|PATCH
 +
|Вы прикладываете патч
 +
|-
 +
|REGRESSION
 +
|Возникла регрессия (ранее программа работала, сейчас нет)
 +
|-
 +
|TRANSLATION
 +
|Вы делаете перевод
 +
|-
 +
|ntvdm
 +
|Отчет связан с DOS-эмулятором ReactOS
 +
|-
 +
|shell-experiments
 +
|Отчет связан с веткой shell-experiments
 +
|-
 +
|rosbe
 +
|Отчет связан с системой сборки ReactOS
 +
|-
 +
|usb
 +
|Проблемы с USB
 +
|-
 +
|setup
 +
|
 +
|-
 +
|website
 +
|Вопрос по веб-сайту
 +
|}
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable" style="float:center; margin-left:2em"
 +
!colspan="2" |Модуль
 +
|-
 +
|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'''"
 
1.Выберите тип запроса «Новая разработка», и введите тему. Например "'''Programs for the Center of applications ReactOS'''" или "'''rapps: add new program'''"
 
<center>[[Файл:Addapp1.png|500пкс]]</center>
 
<center>[[Файл:Addapp1.png|500пкс]]</center>
 
3.В описании напишите что-нибудь наподобие "'''Please, add this program in application manager'''" и добавьте патч. Так же в строке "Метки" введите: '''patch''', а в строке "Module": '''rapps'''.
 
3.В описании напишите что-нибудь наподобие "'''Please, add this program in application manager'''" и добавьте патч. Так же в строке "Метки" введите: '''patch''', а в строке "Module": '''rapps'''.
 
<center>[[Файл:Addapp2.png|500пкс]]</center>
 
<center>[[Файл:Addapp2.png|500пкс]]</center>
−
==Отправка перевода==
+
===Отправка перевода===
−
Основы перевода и отправку отчета см. на еще одной [http://reactosruswiki.zz.mu/index.php?title=Основы_перевода русскоязычной вики]
+
Основы перевода и отправку отчета см. [[ROS Translation introduction|здесь]].
  
−
=Отправка=
+
==Отправка==
 
Нажмите «Создать» и ждите пока разработчики не исправят эту ошибку. Информация о каких-либо действиях к отчету (например в комментариях разработчики могут уточнить некоторые детали, или написать о исправлении бага) будет приходить на почту.
 
Нажмите «Создать» и ждите пока разработчики не исправят эту ошибку. Информация о каких-либо действиях к отчету (например в комментариях разработчики могут уточнить некоторые детали, или написать о исправлении бага) будет приходить на почту.
  
−
=См. так же=
+
==См. так же==
 
*[[Создание_debug-лога_с_помощью_VirtualBox|Создание debug-лога с помощью VirtualBox]]
 
*[[Создание_debug-лога_с_помощью_VirtualBox|Создание debug-лога с помощью VirtualBox]]
 
*[[Как_добавить_программу_в_менеджер_приложений|Как добавить программу в менеджер приложений]]
 
*[[Как_добавить_программу_в_менеджер_приложений|Как добавить программу в менеджер приложений]]
 +
*[[Debugging|Отладка в ReactOS]]
 +
*[[ROS debug2screen|Отладка на экран]]
 
{{ReactOS}}
 
{{ReactOS}}

Текущая версия на 23:10, 4 декабря 2017

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

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

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

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

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

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

Jira.png

2.Войдите

Jira-login.png

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

Makezap.png

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

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

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

Debug-start.png

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

Makebug1.png

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

Makebug2.png

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

Первые шаги

Если вам кажется, что вы обнаружили ошибку в 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"

Addapp1.png

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

Addapp2.png

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

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

Отправка

Нажмите «Создать» и ждите пока разработчики не исправят эту ошибку. Информация о каких-либо действиях к отчету (например в комментариях разработчики могут уточнить некоторые детали, или написать о исправлении бага) будет приходить на почту.

См. так же

ReactOS
Search.png
Доклады
О ReactOS • ARWINSS • ЧеЗа
Информация Новости Выпуски новостей • Переводы блогов • Новости проекта • Видео • ReactOS на Хабре • USB от Вадима Галянта
Разработка Руководство по программированию • Отсутствующая функциональность • Ветви разработки • Компоненты системы • ReactOS и Wine • План работ • Roadmap ядра by Vgal • Разработчики • Совместимость с dll Windows • Наиболее значимые изменения за год • Используемые проекты • Google Summer of Code • Известные проблемы
Порты AMD64 • ARM • Xbox • PowerPC
Компоненты Файловые системы • Режим совместимости • Отчеты об ошибках • Печать • USB • Ядро
Загрузчик Восстановление MBR • Загрузка из GRUB • Параметры загрузки
Прочее ARWINSS • Приложения в ReactOS • Оформление ReactOS • Координаторы • "Пасхальные яйца" • Монетизация
Другое Типы ядер • FreeWin95
Помощь
RAM-диск ReactOS по PXE • с жесткого диска
Разработка Стиль написания кода • Стандарты RC-файлов • Работа с документацией • Венгерская нотация • GNU Indent • [ Subversion : ветви • слияние • использование TortoiseSVN ] • Основы перевода • Отправка патчей
Репорты Отладка в VirtualBox • Отладка на экран • Добавление программы в менеджер приложений • Отправка отчетов
Отладка Com0com • GDB • Kdbg • Rossym.gdb • Roswin.gdb • WinDBG • Руководство по WinDBG • Включение трассировки ядра • Коды DPRINT • Удалённый отладчик ReactOS
Сборка CMake • RBuild • Файлы RBuild • Автоматическое копирование файлов • Сборка MINGW-w64 • Сборка модулей • Среда сборки
Тестирование VirtualBox • VMware • QEMU • Hyper-V • Необходимый объём диска • Перенос файлов на виртуальный диск • Установка ReactOS • Установка драйверов
Сеть Общие папки • Samba • NFS
Игры Установка DirectPlay
Обновление ReactOS • Загрузочная флешка • Чем можно помочь проекту • Создание нового пользователя • Звук и сеть в VirtualBox • Съемка и публикация видео • IRC-канал • Сторонние компоненты • FAQ • ReactOS как рабочая станция • ReactOS и UEFI
Обзоры Оболочка • NTVDM • WOW • Community Edition • История сайта • ReactOS Server • Криптография • ПО времен XP
Источник — «http://winehq.org.ru/index.php?title=Send_report&oldid=4955»