aboutsummaryrefslogtreecommitdiff
path: root/website/content/ru/gnome/docs/bugging.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'website/content/ru/gnome/docs/bugging.adoc')
-rw-r--r--website/content/ru/gnome/docs/bugging.adoc32
1 files changed, 32 insertions, 0 deletions
diff --git a/website/content/ru/gnome/docs/bugging.adoc b/website/content/ru/gnome/docs/bugging.adoc
new file mode 100644
index 0000000000..117598cf7d
--- /dev/null
+++ b/website/content/ru/gnome/docs/bugging.adoc
@@ -0,0 +1,32 @@
+---
+title: "Проект FreeBSD GNOME: Как сообщить об ошибке"
+sidenav: gnome
+---
+
+= Проект FreeBSD GNOME: Как сообщить об ошибке
+
+== 1. О чём сообщать?
+
+Руководствоваться нужно следующим: сообщайте максимальное количество информации. Даже если будет присутствовать какая-то избыточная информация, разработчики её просто отбросят. С другой стороны, гораздо хуже выглядит ситуация, когда для выявления или повторения ошибочной ситуации информации слишком мало - в этом случае разработчики будут терять время на то, чтобы попытаться угадать и/или выяснить подробности у того, кто сообщил о проблеме.
+
+Есть достаточно примеров абсолютно бесполезных сообщений об ошибках, нечто вроде _"Эй, порт gnomefoo не работает. Я использую FreeBSD-X.Y. Исправьте, пожалуйста."_ Не нужно говорить, что такие сообщения являются просто потерей вашего времени, времени соответствующего разработчика и пропускной способности сети. Как минимум сообщение должно включать следующую информацию:
+
+* Точная версия операционной системы (обычно выдаётся командой `uname -a`).
+* Перечень всех пакаджей, установленных в вашей системе.
+* Настройки вашего окружения (выдача команды `/usr/bin/env`).
+* Если вы выполняете построение из портов, то примерное время, когда вы последний раз обновляли ваше дерево портов.
+* Информация, специфичная для каждого типа неисправности: полный журнал неудачного построения в случае, когда построение порта окончилось неудачно, трассировка стека в случае выдачи аварийного дампа памяти, чёткое и подробное описание проблемы, если приложение выполняет какие-то неожиданные действия, и так далее. Попытайтесь поставить себя на место разработчиков и в каждом конкретном случае понять, какая информация будет им необходима для выяснения причин возникновения проблемы. Не думайте, что они уже всё знают о проблеме, и лишь ленятся её исправить.
+
+Если у вас есть решение или способ обхода проблемы, то включите его в ваше сообщение, даже если вы не совсем уверены, что это решение является правильным. Даже если это всё же не так, предложенный вами способ может натолкнуть разработчика на мысли о том, где это нужно посмотреть; и это сэкономит ему время.
+
+== 2. Куда сообщать?
+
+Перед тем, как сообщать об ошибке или даже посылать письмо в список рассылки, http://www.freebsd.org/search/[выполните поиск] в архивах списка рассылки FreeBSD GNOME на предмет того, не сообщалось ли уже об этой проблеме ранее. Большинство проблем, о которых пишется в списке рассылки, повторяются, и при помощи поиска вы сможете найти решение гораздо быстрее.
+
+Как только вы убедились, что это новая проблема, существует несколько способов сообщить об ошибке в GNOME под управлением FreeBSD: вы можете выслать сообщение в адрес mailto:freebsd-gnome@FreeBSD.org[списка рассылки freebsd-gnome], заполнить форму с сообщением в http://www.freebsd.org/support#gnats[системе отслеживания ошибок FreeBSD], послать своё сообщение конкретному разработчику GNOME через их http://bugzilla.gnome.org/[систему отслеживания ошибок] или воспользоваться любой комбинацией из этих способов.
+
+Невозможно однозначно описать, куда следует направлять сообщение в каждом конкретном случае - вам нужно использовать соображения общего характера, однако вот некоторые правила, которым нужно следовать:
+
+* Если проблема специфична для FreeBSD и имеет временный характер (к примеру, несовпадение контрольных сумм, ошибка при наложении патча, синтаксическая ошибка в файле Makefile порта и так далее), то сообщайте о ней в mailto:freebsd-gnome@FreeBSD.org[список рассылки freebsd-gnome].
+* Если проблема однозначно не является специфичной для FreeBSD и у вас нет готового решения, то сообщите непосредственно разработчикам программного обеспечения (для большинства основных компонентов GNOME это означает, что вы должны воспользоваться их системой отслеживания проблем Bugzilla).
+* Если проблема не является специфичной для FreeBSD, но достаточно серьёзной, и у вас есть исправления, то сообщите в обе системы отслеживания ошибок, как FreeBSD, так и автора, чтобы этот конкретный порт был исправлен и другие пользователи FreeBSD смогли использовать ваше исправление, без ожидания следующего релиза от разработчика.