Использование системы отслеживания ошибок QGIS - История изменений

Максим Дубинин: переименовал Using QGIS bugtracker в Использование системы отслеживания ошибок QGIS

2012-03-18T07:37:14Z

переименовал Using QGIS bugtracker в Использование системы отслеживания ошибок QGIS

← Предыдущая версия

Версия от 09:37, 18 марта 2012

Максим Дубинин в 07:36, 18 марта 2012

2012-03-18T07:36:42Z

← Предыдущая версия		Версия от 09:36, 18 марта 2012
Строка 1:		Строка 1:
	{{Статья\|Черновик}}		{{Статья\|Черновик}}
	Эта статья является кратким руководством по использованию системы отслеживания ~~ошибкок~~ (багтрекера, от англ. bug tracking system) Quantum GIS. В первую		Эта статья является кратким руководством по использованию системы отслеживания ошибок (багтрекера, от англ. bug tracking system) Quantum GIS. В первую очередь она предназначена для пользователей, которые хотят оказать посильную помощь разработчикам и сделать QGIS лучше.
	очередь она предназначена для пользователей, которые хотят оказать посильную помощь разработчикам и сделать QGIS лучше.

	== Общие сведения ==		== Общие сведения ==
	Багтрекер это система, позволяющая вести учет ошибок, найденных в программном продукте, а также пожеланий пользователей. Quantum GIS использует в качестве багтрекера Redmine — открытую систему управления проектами, написанную на Ruby. Расположен багтрекер по адресу http://hub.qgis.org/.		Багтрекер - это система, позволяющая вести учет ошибок, найденных в программном продукте, а также пожеланий пользователей. Quantum GIS использует в качестве багтрекера Redmine — открытую систему управления проектами, написанную на Ruby. Расположен багтрекер по адресу http://hub.qgis.org/.

	Просматривать записи в redmine могут все желающие, но для полноценного использования системы необходимо зарегистрироваться. Так как QGIS является одним из проектов [http://www.osgeo.org/ OSGeo], для входа в redmine используется [http://www.osgeo.org/osgeo_userid OSGeo ID] ([https://www.osgeo.org/cgi-bin/ldap_create_user.py регистрационная форма]).		Просматривать записи в redmine могут все желающие, но для полноценного использования системы необходимо зарегистрироваться. Так как QGIS является одним из проектов [http://www.osgeo.org/ OSGeo], для входа в redmine используется [http://www.osgeo.org/osgeo_userid OSGeo ID] ([https://www.osgeo.org/cgi-bin/ldap_create_user.py регистрационная форма]).

Максим Дубинин в 18:38, 26 января 2012

2012-01-26T18:38:11Z

← Предыдущая версия		Версия от 20:38, 26 января 2012
Строка 1:		Строка 1:
			{{Статья\|Черновик}}
	Эта статья является кратким руководством по использованию системы отслеживания ошибкок (багтрекера, от англ. bug tracking system) Quantum GIS. В первую		Эта статья является кратким руководством по использованию системы отслеживания ошибкок (багтрекера, от англ. bug tracking system) Quantum GIS. В первую
	очередь она предназначена для пользователей, которые хотят оказать посильную помощь разработчикам и сделать QGIS лучше.		очередь она предназначена для пользователей, которые хотят оказать посильную помощь разработчикам и сделать QGIS лучше.

Voltron: /* Сообщаем об ошибке */

2012-01-21T12:06:37Z

Сообщаем об ошибке

← Предыдущая версия		Версия от 14:06, 21 января 2012
Строка 38:		Строка 38:

	[[Файл:Redmine-05.png\|700px\|thumb\|center\|<center>Поиск и просмотр существующих сообщений</center>]]		[[Файл:Redmine-05.png\|700px\|thumb\|center\|<center>Поиск и просмотр существующих сообщений</center>]]

			Искать рекомендуется среди всех ошибок, а не только среди открытых, т.к. может иметь место так называемая «регрессия». Регрессия — это ошибка, которая уже была когда-то исправлена, но возникла снова. В таких случаях новое сообщение не создается, а «переоткрывается» старое.

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

	Избегайте редактирования уже отправленных комментариев за исключением исправления опечаток, во всех остальных случаях лучше добавить еще один комментарий. Обратите внимание, что есть две кнопки редактирования «Update»: одна вверху, на уровне заголовка сообщения, а вторая — внизу, под последним комментарием.		Избегайте редактирования уже отправленных комментариев за исключением исправления опечаток, во всех остальных случаях лучше добавить еще один комментарий. Обратите внимание, что есть две кнопки редактирования «Update»: одна вверху, на уровне заголовка сообщения, а вторая — внизу, под последним комментарием. Верхняя кнопка используется для изменения самого сообщения (например, можно изменить приоритет или дополнить список систем, на которых ошибка воспроизводится), а нижняя используется для добавления нового комментария.

	[[Файл:Redmine-07.png\|700px\|thumb\|center\|<center>Отправленное сообщение</center>]]		[[Файл:Redmine-07.png\|700px\|thumb\|center\|<center>Отправленное сообщение</center>]]

Voltron: /* Сообщаем об ошибке */

2012-01-21T11:37:46Z

Сообщаем об ошибке

← Предыдущая версия		Версия от 13:37, 21 января 2012
Строка 71:		Строка 71:
	После отправки сообщения стоит «подписаться» на него, нажав на «Watch». Это позволит вам быть в курсе всех изменений, касающихся данной ошибки. Например, разработчики закрою ошибку или кто-то оставит комментарий, в этих случаях вы получите уведомление на почту.		После отправки сообщения стоит «подписаться» на него, нажав на «Watch». Это позволит вам быть в курсе всех изменений, касающихся данной ошибки. Например, разработчики закрою ошибку или кто-то оставит комментарий, в этих случаях вы получите уведомление на почту.

	Избегайте редактирования уже отправленных комментариев за исключением исправления опечаток, во всех остальных случаях лучше добавить еще один комментарий.		Избегайте редактирования уже отправленных комментариев за исключением исправления опечаток, во всех остальных случаях лучше добавить еще один комментарий. Обратите внимание, что есть две кнопки редактирования «Update»: одна вверху, на уровне заголовка сообщения, а вторая — внизу, под последним комментарием.

	[[Файл:Redmine-07.png\|700px\|thumb\|center\|<center>~~Оформляем ошибку~~</center>]]		[[Файл:Redmine-07.png\|700px\|thumb\|center\|<center>Отправленное сообщение</center>]]

	Поскольку разработчиков не так уж и много и все они занимаются проектом в свободное время не стоит расчитывать, что ваша ошибка будет сразу же		Поскольку разработчиков не так уж и много и все они занимаются проектом в свободное время не стоит расчитывать, что ваша ошибка будет сразу же

Voltron: Добавил картинки

2012-01-21T11:32:49Z

Добавил картинки

← Предыдущая версия		Версия от 13:32, 21 января 2012
Строка 8:		Строка 8:

	После получения OSGeo ID открываем страницу http://hub.qgis.org/ и в правом верхнем углу жмем на ссылку «Войти». После ввода своих регистрационных данных мы попадем в систему.		После получения OSGeo ID открываем страницу http://hub.qgis.org/ и в правом верхнем углу жмем на ссылку «Войти». После ввода своих регистрационных данных мы попадем в систему.

			[[Файл:Redmine-01.png\|700px\|thumb\|center\|<center>Стартовая страница багтрекера QGIS</center>]]

	Сначала стоит озаботиться настройкой своей учетной записи: переходим по ссылке «My account» в правом верхнем углу, на открывшейся странице заполняем		Сначала стоит озаботиться настройкой своей учетной записи: переходим по ссылке «My account» в правом верхнем углу, на открывшейся странице заполняем
Строка 14:		Строка 16:
	* Lastname		* Lastname
	* Email (на указанную почту будут приходить уведомления)		* Email (на указанную почту будут приходить уведомления)

			[[Файл:Redmine-03.png\|700px\|thumb\|center\|<center>Редактирование учетной записи</center>]]

	Здесь же можно указать предпочитаемый язык интерфейса (используется только после авторизации в системе), временную зону и порядок отображения записей.		Здесь же можно указать предпочитаемый язык интерфейса (используется только после авторизации в системе), временную зону и порядок отображения записей.
Строка 32:		Строка 36:

	Далее, проверяем, а не сообщал ли о ней кто-то еще: открываем в браузере страницу http://hub.qgis.org/projects/quantum-gis/issues и при помощи фильтров пытаемся найти нашу ошибку. Также можно выполнять поиск по ключевым словам http://hub.qgis.org/search/index/.		Далее, проверяем, а не сообщал ли о ней кто-то еще: открываем в браузере страницу http://hub.qgis.org/projects/quantum-gis/issues и при помощи фильтров пытаемся найти нашу ошибку. Также можно выполнять поиск по ключевым словам http://hub.qgis.org/search/index/.

			[[Файл:Redmine-05.png\|700px\|thumb\|center\|<center>Поиск и просмотр существующих сообщений</center>]]

	После того, как имеется четкий воспроизводимый пример и тестовый набор данных (если ошибка возникает на каких-то специфических данных) и мы убедились,		После того, как имеется четкий воспроизводимый пример и тестовый набор данных (если ошибка возникает на каких-то специфических данных) и мы убедились,
Строка 60:		Строка 66:

	Перед отправкой сообщения проверьте форматирование, воспользовавшись кнопкой «Preview».		Перед отправкой сообщения проверьте форматирование, воспользовавшись кнопкой «Preview».

			[[Файл:Redmine-06.png\|700px\|thumb\|center\|<center>Оформляем ошибку</center>]]

	После отправки сообщения стоит «подписаться» на него, нажав на «Watch». Это позволит вам быть в курсе всех изменений, касающихся данной ошибки. Например, разработчики закрою ошибку или кто-то оставит комментарий, в этих случаях вы получите уведомление на почту.		После отправки сообщения стоит «подписаться» на него, нажав на «Watch». Это позволит вам быть в курсе всех изменений, касающихся данной ошибки. Например, разработчики закрою ошибку или кто-то оставит комментарий, в этих случаях вы получите уведомление на почту.

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

			[[Файл:Redmine-07.png\|700px\|thumb\|center\|<center>Оформляем ошибку</center>]]

	Поскольку разработчиков не так уж и много и все они занимаются проектом в свободное время не стоит расчитывать, что ваша ошибка будет сразу же		Поскольку разработчиков не так уж и много и все они занимаются проектом в свободное время не стоит расчитывать, что ваша ошибка будет сразу же

Voltron: Add GIS-Lab workflow

2012-01-19T19:21:09Z

Add GIS-Lab workflow

← Предыдущая версия		Версия от 21:21, 19 января 2012
Строка 26:		Строка 26:
	* пробуем вызвать ошибку на другом наборе данных		* пробуем вызвать ошибку на другом наборе данных
	* иногда причиной ошибок могут быть модули. Поэтому, если активированы какие-либо модули — поочередно отключаем их и пробуем воcпроизвести ошибку		* иногда причиной ошибок могут быть модули. Поэтому, если активированы какие-либо модули — поочередно отключаем их и пробуем воcпроизвести ошибку

			Также стоит привлечь к процессу проверки других пользователей и тем самым не только ускорить процесс, но и собрать больше информации о самой ошибке (например, что она проявляется только на какой-то конкретной версии или только в какой-то определенной ОС). Для этого авторизуемся на форуме GIS-Lab, и в разделе [http://gis-lab.info/forum/viewforum.php?f=35 Oшибки QGIS] форума QGIS создаем сообщение с описанием ошибки, предварительно ознакомившись с [http://gis-lab.info/forum/viewtopic.php?f=35&t=4287 правилами оформления].

	В процессе, по возможности, собираем доступную отладочную информацию, предшествующую возникновению ошибки (отладочные сообщения в консоли, сообщения из окна Message Log в последних версия QGIS). Если есть возможность, лучше проверять на последней версии, так называемый master (он же trunk), или использовать последнюю ночную сборку. Также имеет смысл проверить и последнюю «стабильную версию» (на момент написания статьи это 1.7.3)		В процессе, по возможности, собираем доступную отладочную информацию, предшествующую возникновению ошибки (отладочные сообщения в консоли, сообщения из окна Message Log в последних версия QGIS). Если есть возможность, лучше проверять на последней версии, так называемый master (он же trunk), или использовать последнюю ночную сборку. Также имеет смысл проверить и последнюю «стабильную версию» (на момент написания статьи это 1.7.3)

	Далее, проверяем, а не сообщал ли о ней кто-то еще: открываем в браузере страницу http://hub.qgis.org/projects/quantum-gis/issues и при помощи фильтров пытаемся найти нашу ошибку. Также можно выполнять поиск по ключевым словам http://hub.qgis.org/search/index/		Далее, проверяем, а не сообщал ли о ней кто-то еще: открываем в браузере страницу http://hub.qgis.org/projects/quantum-gis/issues и при помощи фильтров пытаемся найти нашу ошибку. Также можно выполнять поиск по ключевым словам http://hub.qgis.org/search/index/.

	После того, как имеется четкий воспроизводимый пример и тестовый набор данных (если ошибка возникает на каких-то специфических данных) и мы убедились,		После того, как имеется четкий воспроизводимый пример и тестовый набор данных (если ошибка возникает на каких-то специфических данных) и мы убедились,
	что этой ошибки в багтрекере нет можно оформлять сообщение:		что этой ошибки в багтрекере нет, можно оформлять сообщение:
	* авторизуемся в багтрекере при помощи своего OSGeo ID		* авторизуемся в багтрекере при помощи своего OSGeo ID
	* переходим к проекту [http://hub.qgis.org/projects/quantum-gis Quantum GIS Desktop]		* переходим к проекту [http://hub.qgis.org/projects/quantum-gis Quantum GIS Desktop]
Строка 67:		Строка 69:

	== Оставляем пожелание ==		== Оставляем пожелание ==
	Если для полного счастья вам не хватает какой-то функции или возможности, об этом тоже стоит сообщать разработчикам. Для этого используется все тот		Если для полного счастья вам не хватает какой-то функции или возможности, об этом тоже стоит сообщать разработчикам. Но для начала лучше убедиться, что наши запросы не слишком экзотичны. Для этого предназначен раздел [http://gis-lab.info/forum/viewforum.php?f=36 Предложения] форума QGIS. Читаем [http://gis-lab.info/forum/viewtopic.php?f=36&t=4319 правила], создаем новую тему и собираем комментарии. Если большинство предложение восприняло положительно, идем оформлять пожелание (feature request).
	же багтрекер и та же страница «New Issue». Незначительные отличия только в заполнении формы:
			Для этого используется все тот же багтрекер и та же страница «New Issue». Незначительные отличия только в заполнении формы:
	* в поле '''Tracker''' указывается тип сообщения: запрос нового функционала (''Feature'')		* в поле '''Tracker''' указывается тип сообщения: запрос нового функционала (''Feature'')
	* '''Subject''' — короткое и ясное описание недостающей функции		* '''Subject''' — короткое и ясное описание недостающей функции
Строка 86:		Строка 89:
	* ссылка на тикет добавляется на страницу http://hub.qgis.org/wiki/quantum-gis/Bugs		* ссылка на тикет добавляется на страницу http://hub.qgis.org/wiki/quantum-gis/Bugs

	Также стоит связаться с Paolo Cavalini, который поможет в правильной организации процесса.		Также стоит связаться с [http://www.faunalia.co.uk/who Paolo Cavalini], который поможет в правильной организации процесса.

	== Ccылки ==		== Ccылки ==
	# [http://hub.qgis.org/wiki/quantum-gis/Bugreports How to report bugs]		# [http://hub.qgis.org/wiki/quantum-gis/Bugreports How to report bugs]
	# [http://hub.qgis.org/wiki/quantum-gis/Bugs Squash bugs for money]		# [http://hub.qgis.org/wiki/quantum-gis/Bugs Squash bugs for money]

Voltron: Started: Using QGIS bugtracker

2012-01-19T19:03:07Z

Started: Using QGIS bugtracker

Новая страница

Эта статья является кратким руководством по использованию системы отслеживания ошибкок (багтрекера, от англ. bug tracking system) Quantum GIS. В первую
очередь она предназначена для пользователей, которые хотят оказать посильную помощь разработчикам и сделать QGIS лучше.

== Общие сведения ==
Багтрекер это система, позволяющая вести учет ошибок, найденных в программном продукте, а также пожеланий пользователей. Quantum GIS использует в качестве багтрекера Redmine — открытую систему управления проектами, написанную на Ruby. Расположен багтрекер по адресу http://hub.qgis.org/.

Просматривать записи в redmine могут все желающие, но для полноценного использования системы необходимо зарегистрироваться. Так как QGIS является одним из проектов [http://www.osgeo.org/ OSGeo], для входа в redmine используется [http://www.osgeo.org/osgeo_userid OSGeo ID] ([https://www.osgeo.org/cgi-bin/ldap_create_user.py регистрационная форма]).

После получения OSGeo ID открываем страницу http://hub.qgis.org/ и в правом верхнем углу жмем на ссылку «Войти». После ввода своих регистрационных данных мы попадем в систему.

Сначала стоит озаботиться настройкой своей учетной записи: переходим по ссылке «My account» в правом верхнем углу, на открывшейся странице заполняем
поля формы:
* Firstname
* Lastname
* Email (на указанную почту будут приходить уведомления)

Здесь же можно указать предпочитаемый язык интерфейса (используется только после авторизации в системе), временную зону и порядок отображения записей.
Рекомендуется установить отправку оповещений хотя бы в режим «Only for things I watch or I'm involved in», что позволит оперативно реагировать на изменения и комментарии.

Общение в багтрекере ведется на английском языке.

== Сообщаем об ошибке ==

Итак, в процессе работы обнаружена какая-то ошибка (или нам кажется, что это ошибка). Сначала нужно убедиться, что ошибка воспроизводится:
* пробуем вызвать ошибку на этом же наборе данных
* пробуем вызвать ошибку на другом наборе данных
* иногда причиной ошибок могут быть модули. Поэтому, если активированы какие-либо модули — поочередно отключаем их и пробуем воcпроизвести ошибку

В процессе, по возможности, собираем доступную отладочную информацию, предшествующую возникновению ошибки (отладочные сообщения в консоли, сообщения из окна Message Log в последних версия QGIS). Если есть возможность, лучше проверять на последней версии, так называемый master (он же trunk), или использовать последнюю ночную сборку. Также имеет смысл проверить и последнюю «стабильную версию» (на момент написания статьи это 1.7.3)

Далее, проверяем, а не сообщал ли о ней кто-то еще: открываем в браузере страницу http://hub.qgis.org/projects/quantum-gis/issues и при помощи фильтров пытаемся найти нашу ошибку. Также можно выполнять поиск по ключевым словам http://hub.qgis.org/search/index/

После того, как имеется четкий воспроизводимый пример и тестовый набор данных (если ошибка возникает на каких-то специфических данных) и мы убедились,
что этой ошибки в багтрекере нет можно оформлять сообщение:
* авторизуемся в багтрекере при помощи своего OSGeo ID
* переходим к проекту [http://hub.qgis.org/projects/quantum-gis Quantum GIS Desktop]
* открываем страницу добавления нового сообщения «New Issue»
* заполняем форму

При заполнении формы нужно обращать внимание на следующие моменты:
* в поле '''Tracker''' указывается тип сообщения: ошибка (''Bug'')
* в поле '''Subject''' — короткое и ясное описание ошибки
* '''Description''' — развернутое описание ошибки с указанием последовательности действий для воспроизведения, версиями используемого ПО, платформы (ОС) и любой другой полезной информации
* в поле '''Priority''' указывается предполагаемая важность ошибки (в последствии может быть изменена администраторами). Сейчас используется такая классификация:
** ''Low'' — ошибка не мешающая повседневному использованию QGIS, и, вероятно, легко исправляющаяся
** ''Normal'' — значение по умолчанию, применяется к большинству сообщений об ошибках и запросам нового функционала
** ''High'' — ошибка оказывающая значительное влияние на удобство использования в некоторых случаях, в то же время не мешающая использовать QGIS для других задач
** ''Urgent'' — делает использование QGIS практически невозможным или приводит к потере данных
** ''Immediate'' — делает использование QGIS полностью не возможным или приводит к полной потере данных
* '''Component''' — здесь указывается подсистема, в которой возникает ошибка
* '''Affected version''' — если ошибка возникает в какой-то определенной версии QGIS, стоит указать эту версию (по умолчанию master). Т.к. поле пока не позволяет указывать несколько версий одновременно, указывайте самую старую проверенную версию, а в поле Description перечислите все проверенные
* '''Target version''' — здесь указывается к выходу какой, по вашему мнению, версии QGIS данная ошибка должна быть исправлена. Но это не значит, что она обязательно будет исправлена к выходу именно этой версии
* '''Platform''' и '''Platform version''' — соответственно название и версия используемой ОС
* флаг '''Patch supplied''' устанавливается, если вы исправили ошибку самостоятельно и приложили к сообщению патч, исправляющий эту ошибку
* флаг '''Causes crash or corruption''' устанавливается, если ошибка приводит к падению QGIS или потере данных
* '''Assigned to''' — если вы знаете кто отвечает за данную подсистему, можете указать разработчика в этом поле
* поле '''Files''' используется для загрузки дополнительных данных (тестовый набор данных, скриншоты, патчи и т.д.)

Перед отправкой сообщения проверьте форматирование, воспользовавшись кнопкой «Preview».

После отправки сообщения стоит «подписаться» на него, нажав на «Watch». Это позволит вам быть в курсе всех изменений, касающихся данной ошибки. Например, разработчики закрою ошибку или кто-то оставит комментарий, в этих случаях вы получите уведомление на почту.

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

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

== Оставляем пожелание ==
Если для полного счастья вам не хватает какой-то функции или возможности, об этом тоже стоит сообщать разработчикам. Для этого используется все тот
же багтрекер и та же страница «New Issue». Незначительные отличия только в заполнении формы:
* в поле '''Tracker''' указывается тип сообщения: запрос нового функционала (''Feature'')
* '''Subject''' — короткое и ясное описание недостающей функции
* '''Description''' — развернутое описание

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

== Bounty ==
Если ошибка или пожелание зафиксированы в багтрекере и никто ими не занимается, а вам именно эта ошибка очень мешает или нехватает именно вот
этой функции, можно попробовать еще одно средство — Bounty.

Bounty (премия) это некоторое вознаграждение, которое вы готовы выплатить разработчику, исправившему ошибку или реализовавшему функционал. Работает
это следующим образом:
* если соответсвующая ошибка уже есть в трекере, то ее необходимо отредактировать, установив поле '''Tracker''' в ''Bounty''. Или же сразу создать сообщение такого типа
* в поле '''Bounty value in euros''' указывается размер вознаграждения
* ссылка на тикет добавляется на страницу http://hub.qgis.org/wiki/quantum-gis/Bugs

Также стоит связаться с Paolo Cavalini, который поможет в правильной организации процесса.

== Ccылки ==
# [http://hub.qgis.org/wiki/quantum-gis/Bugreports How to report bugs]
# [http://hub.qgis.org/wiki/quantum-gis/Bugs Squash bugs for money]