<p>Так как наши разработчики не в состоянии проверить все комбинации компьютерных комплектующих и программных средств при их работе в Haiku, то мы полагаемся на пользователей, надеясь, что вы сообщите нам об обнаруженных ошибках, которых, ввиду молодости Haiku, может быть немало. Мы будем благодарны вам за потраченное на составление отчёта время, только вместе мы сможем сделать Haiku лучше.</p>
<p>Для продуктивной работы c системой отслеживания ошибок (багтрекером) важно соблюдать принятый в нём <ahref="http://dev.haiku-os.org/wiki/BugTrackerEtiquette">этикет</a>.</p>
<p>Чтобы создать новый багрепорт, у вас должен быть заведён аккаунт в <ahref="http://dev.haiku-os.org/register"title="Регистрация в багтрекере Haiku">багтрекере Haiku</a>.<br/>
Создавая новый аккаунт <b>обязательно введите адрес электронной почты</b>, так как на него будут приходить все сведения, связанные с изменением багрепорта. Убедитесь, что приходящие с багтрекера письма <b>не помечаются как спам,</b> так как это вполне возможно.</p>
<p>Прежде чем сообщать об ошибке, пожалуйста, <ahref="http://dev.haiku-os.org/query?status=new&status=assigned&status=reopened&status=closed&summary=%7Eтекст,+который+вы+ищите&order=priority">убедитесь</a>, что аналогичного багрепорта ещё не существует. Для этого также можно воспользоваться функцией <ahref="http://dev.haiku-os.org/search?q=&noquickjump=1&ticket=on">поиска</a>.<br/>
После того как вы установили, что подобных багрепортов не имеется, то оформите вашу информацию как можно точнее:</p>
<li><p>Включите информацию о том как вы тестируете Haiku (на реальном компьютере, в эмуляторе VMWare, QEMU, и т. д.).</p></li>
<li><p>Укажите какую <acronymtitle="Subversion - система управления версиями, используемая нами">SVN</acronym> ревизию Haiku вы используете. Эту информацию можно найти в '<i>Сведениях о системе (About This System)...</i>' в меню Deskbar.</p></li>
<li><p>Опишите проблему, с которой вы столкнулись, попытайтесь описать её наиболее точно: как именно она проявилась, и как правильно должен бы был действовать проблемный объект при её отсутствии.</p></li>
<li><p>Расскажите какие шаги нужно выполнить для её возникновения, что поможет разработчикам воспроизвести эту ошибку.</p></li>
<li><p>Прикрепите всю имеющуюся информацию. Если это ошибка графического интерфейса или баг в каком-либо приложении, то попытайтесь сделать скриншот (клавиша <spanclass="key">PrintScreen</span> сохраняет PNG изображение в папке <spanclass="path">/boot/home/</span>).</p></li>
<p>Когда приложение аварийно завершилось, вы должны использовать автоматически открывающийся отладчик. Введя в окне терминала с дебагером <spanclass="cli">bt</span>, вы создаёте "трассировку", которую необходимо скопировать в ваш багрепорт.</p>
<li><spanclass="cli">listdev</span> - подробный список оборудования, включающий ID поставщиков и отдельных устройств, схожа с командами Linux <spanclass="cli">lshw</span> и <spanclass="cli">lspci</span>.</li>
<li><spanclass="cli">listusb -v</span> - при ошибке, связанной с USB, аналогична команде <spanclass="cli">lsusb</span>.</li>
<li><spanclass="cli">open /var/log/syslog</span> - основной системный лог используемый Haiku, сродни выводимой на экран отладочной информации при загрузке в соответствующем режиме. С командой <spanclass="cli">open</span> можно вырезать нужную часть лога в текстовом редакторе.</li>
<li><spanclass="cli">listimage | grep drivers/</span> - список всех задействованных драйверов.</li>
<li><spanclass="cli">ints</span> - доступна только в режиме <i>Царства отладки ядра (Kernel Debugging Land - KDL)</i> (см. ниже), отображает используемые прерывания. Не должно быть слишком много устройств, использующих одно прерывание.</li>
<p>Все эти команды вводитятся в терминале, если не указано иное. Если добавить <spanclass="cli">> output.txt</span> после команды, то результат её работы сохранится в текстовый файл "output.txt", который можно прикрепить к своему сообщению об ошибках или отправить по электронной почте.</p>
<p>Когда какой-либо системный низкоуровневый компонент вызывает фатальную ошибку, то вы, с большой долей вероятности, окажетесь в отладчике ядра. Также он может быть вызван намеренно при нажатии на клавиши <spanclass="key">ALT</span>+<spanclass="key">SysReq</span>+<spanclass="key">D</span> (клавиша <spanclass="key">SysReq</span> называется <spanclass="key">PrintScreen</span> на большинстве клавиатур).</p>
<p>После того как багрепорт отправлен, разработчик рассмотрит вашу ошибку и попытаться классифицировать ее. Помните, что мы все добровольцы, и иногда багрепорт может оставаться без ответа некоторое время. Добавление новой информации об ошибке помогает исправить её быстрее, но не пытайтесь увеличить её значимость, добавляя не относящиеся к делу комментарии.</p>
<p>Помните, что отправка багрепорта, на который вы потратили некоторое время - это ещё полдела, и желательно чтобы вы следили за его состоянием. Только в этом случае вы внесёте ощутимую часть в процесс развития Haiku. У разработчиков могут возникнуть вопросы, относящиеся к багу во время его исправления, пожалуйста, не игнорируйте их, постаравшись как можно подробней ответить. Считайте свое участие законченным, только когда ошибка пиобритёт статус "исправлено (fixed)".</p>