пятница, 7 августа 2015 г.

FAQ. Работаем в Mantis

Mantis — человеконенавистный баг-трекер (ИМХО, разумеется). Зато бесплатный (smile)

Поэтому мы учим там моих студентов. Это как учиться вождению — научился на механике и любой автомат тебе по плечу. Поработал в Mantis и расцеловал на реальной работе JIRA (smile)

Студенты спрашивают — «Как заводить задачи? Как аттачить несколько файлов?». Отсюда идея написать FAQ. В публичном блоге — потому что мантис бесплатный и вы тоже можете развернуть его у себя и потренироваться заводить задачи. Итак, поехали.

Выбор проекта


Заводить задачи в пустоту не получится. Нужно выбрать проект. Если в баг-трекере несколько проектов, важно выбрать именно свой =) Иначе наплодите задачки не туда, куда надо. А админу потом страдай и переноси.

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

После этого справа вверху нужно выбрать свой проект (Project) в выпадающем списке и нажать Switch.

Выбор неправильного проекта приведет к гневу админа

Соответственно, если не видите там своего проекта — вас еще не подключили, не дали нужные права.

Новая задача


1. Нажимаем Report Issue. 

Чтобы поставить баг — нажми Report Issue 




2. Заполняем верхние поля. Для нашего баг-трекера:

Category [All Projects] General. Поле обязательное для заполнения, если забыть поставить — мантис не даст сохранить задачу.
Reproducibility — как часто повторяется. Обычно всегда = always.
Severity — серьезность. Это блокер, простая задача или minor? Если заводим улучшение, выбираем feature.
Priority — не трогаем, приоритет ставит менеджер.

Приоритет и воспроизводимость

3. Основные поля формы.

Summary — Название. Кратко, но емко! Студенты обязаны проверить его в Багреде.

Description — Идея бага. Мои студенты ставят там прочерк, потому что практика первых курсов показала, что Description полностью дублирует Summary в 90% случаях. Текст ради текста мне не нужен, поэтому мы учимся обходить ограничения программы. Обязательное поле? Вот тебе прочерк.

Steps To Reproduce — Здесь описывается сама задача. Если это баг, то весь шаблон бага: шаги, результат, ожидаемый. Если улучшение — то текст улучшения.

Для выделения заголовка жирным используются теги <b>:
<b>Шаги</b> = Шаги (в режиме просмотра)

Additional Information — Дополнительная информация, если она нужна. Например, шаги бага описывают конкретное проявление проблемы, а в доп инфо указывается «также повторяется вот тут и вот тут». Не путать с обоснованием бага, которое пишется в теле задачи!

Upload File — Поле для загрузки файла или скриншотика.

Заполнив все поля, нажимаем Submit Report.


См также:
Шаблон бага
Багред — сервис проверки названий багов, первый уровень (типовые ошибки ловит)

APPLICATION ERROR #2800


Что делать, если сидел-сидел, корпел-корпел над описанием задачи, а потом жмешь Submit и получаешь ошибку?

Главное — не паниковать! Помните, мантис ужасен =)
И у него довольно быстро протухает сессия. Долго думал над описанием? Получишь ошибку. Поэтому начинающим рекомендуется сохранять шаги в блокнотике. На всякий случай. В конце концов, вдруг кот по клавиатуре пройдет и браузер закроет?

Если получили ошибку, нажмите Back в браузере — и вернетесь в режим редактирования. Данные никуда не пропадут. Хотя, конечно, вернуть данные можно не всегда, так что отлаживайтесь в блокноте, а в мантисе не тормозите =)

«Назад» вам поможет при такой ошибке. Но не всегда...

Итого — нажимаем «Назад», а потом снова пробуем засабмитить репорт. Если ошибка повторяется, возвращаемся назад, открываем новую вкладку и переносим туда наш текст

Просмотр списка задач


Список задач проекта открывается по ссылке View Issues.
Если вы не видите там задач, которые «точно заводили» — возможно, у вас включен какой-то фильтр, например, Hide closed, сбросьте его и все увидите!

Просмотр задач


Перевод в разработку


Чтобы разработчик увидел задачу, ему надо об этом узнать. Пока задача висит на тестировщике — она еще в доработке самим тестировщиком. Может он файлики новые добавляет или локализовывает проблему... Who knows.

Как перевести задачу на разработчика:

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

Выбираем задачу из списка

Попадаем в режим просмотра. Скролируем вниз, под телом задачи есть всякие кнопочки. Нам надо сделать Assign To и выбрать разработчика, в данном примере это будет molechka.

Assign To — иначе твою задачу даже не посмотрят


Редактирование задачи


Если нужно подредактировать задачу — нажимаем кнопку Edit там же, внизу задачи.



Аттачи — файлы, скриншоты


Во время создания задачи можно прикрепить максимум один файл. Не пытайтесь найти там лазейку и добавить больше =)

Добавлять файлы можно в режиме просмотра — под кнопка редактирования и перевода на разработчика есть блок «Upload file». Выбираем файл, добавляем к задаче.

Несколько файлов можно прикрепить в режиме 
просмотра, по одному

Обратите внимание:

  • Названия файлов должны быть говорящими. а не просто "1", "2", "3"...
  • Скриншоты должны быть видны в режиме просмотра. сами рисунки, а не только ссылка на них. Если скриншоты не видны, уменьшите их размер, ширину и длину.
Если файл был добавлен ошибочно или скриншот слишком большой, вы хотите его заметить — удалить можно с режима просмотра, нажав Delete.


Цветовая раскраска списка задач




Синий — задача назначена на разработчика или на тестировщика, находится в доработке. Пока не зачтена, но и не закрыта. Пока (smile)

Серый — задача закрыта. В комментариях можно прочитать почему. Чаще всего как «won`t fix» (не будет сделана) или «duplicate». Для студентов это означает, что надо искать другую, закрытые в зачет не идут.

Желтый — задача принята. На ней другие студенты могут посмотреть пример оформления, к такому цвету надо стремиться и достигать =)


Пожалуй, из базовых знаний все. Удачи в тренировках!

PS — статья написана в помощь студентам моего курса для начинающих тестировщиков

2 комментария:

  1. Спасибо за инфо) 30 минут пытался найти лазейку и подвязать два скриншотика)

    ОтветитьУдалить