Для разработчиков

Как написать баг-репорт, чтобы ошибку исправили с первого раза

«У меня ничего не работает» — худший баг-репорт: разработчик потратит час, чтобы понять, что именно сломалось. Хорошее описание ошибки экономит время всем. Разбираем шаблон, по которому ошибки исправляют с первого раза.

Для разработчиковКак написать баг-репорт
Задача с описанием ошибки и скриншотом

Шаблон баг-репорта

Где: страница, адрес, раздел
Шаги: 1) открыть… 2) нажать… 3) ввести…
Ожидалось: что должно было произойти
Произошло: что произошло на самом деле
Окружение: браузер, устройство, размер экрана
Вложения: скриншот или запись экрана

Название — суть в одной строке

Не «Ошибка на сайте», а «Форма заявки на странице „Контакты“ не отправляется в Safari на iPhone». По названию разработчик уже понимает, куда смотреть.

Шаги воспроизведения

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

Скриншот и запись экрана

Скриншот с пометками показывает, где проблема. Запись экрана с голосом — как до неё дойти. В MasterTeam и то и другое делается прямо из задачи: кнопкой «Снимок экрана» с разметкой или «Запись экрана» до 5 минут.

Баг в задаче: шаги, ожидание, факт и запись экрана
Баг в задаче: шаги, ожидание, факт и запись экрана

Приоритет

  • High — не работает оплата, заявки, вход.
  • Средний — ошибка мешает, но есть обходной путь.
  • Низкий — опечатка, съехавший отступ.

Одна ошибка — одна задача

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

Questions and answers

Что важнее: скриншот или запись экрана?

Для визуальных ошибок хватит скриншота с пометкой. Если ошибка возникает после нескольких действий — запись экрана быстрее любого текста.

Как указать браузер и устройство?

Достаточно: «Chrome на Windows, ширина окна 1366» или «Safari, iPhone 13». Многие ошибки проявляются только в конкретном браузере.

Кто ставит приоритет ошибке?

Предлагает тот, кто нашёл, а окончательно решает менеджер или руководитель разработки.

Попробуйте MasterTeam бесплатно

Для команды до 5 человек — бесплатно. Список, доска, календарь, таймлайн и отчёты — сразу после регистрации.

Start for free