Баг-репорты, которые любят разработчики: шаблон и реальные примеры
Хороший баг-репорт исправляют быстрее. Вот наш шаблон, пример плохого и хорошего репорта и то, как мы определяем серьёзность и приоритет.
Баг, который невозможно воспроизвести, не исправляют. Баг-репорт, на понимание которого разработчик тратит двадцать минут, откладывают. Качество баг-репортов напрямую влияет на скорость команды, поэтому мы считаем их написание ключевым навыком QA, а не бюрократией.
Анатомия хорошего репорта
| Поле | Что писать |
|---|---|
| Заголовок | Что сломано, где и при каком условии. Коротко и так, чтобы легко найти поиском |
| Окружение | Сборка/версия, URL, устройство, ОС, браузер, тип аккаунта |
| Предусловия | Данные или состояние, нужные до шага 1 |
| Шаги воспроизведения | Пронумерованные, минимальные, одно действие на шаг |
| Ожидаемый результат | Что должно произойти, желательно со ссылкой на требование |
| Фактический результат | Что происходит вместо этого, включая текст ошибки |
| Доказательства | Скриншот, видео, логи, сетевой запрос (HAR), ошибки в консоли |
| Серьёзность / Приоритет | Влияние на продукт / срочность исправления |
| Частота | Всегда, иногда (3 из 10), один раз |
Плохой и хороший
Плохой репорт:
Тот же баг, описанный хорошо:
Заголовок: Оформление – кнопка «Оплатить» остаётся неактивной после применения промокода в мобильном Safari
Окружение: staging build 1.4.2 (#1287), iPhone 13, iOS 17.5, Safari
Аккаунт: зарегистрированный пользователь test.buyer+12@…, корзина из 2 товаров ($64.00)
Шаги:
1. Открыть /cart
2. Ввести промокод SPRING10 и нажать «Применить»
3. Нажать «Оформить» и заполнить корректный адрес
4. Выбрать «Карта» как способ оплаты
Ожидается: кнопка «Оплатить $57.60» активна
Фактически: кнопка неактивна; в консоли
TypeError: total.toFixed is not a function (checkout.js:214)
Частота: 5/5 в iOS Safari; не воспроизводится в Chrome на десктопе
Доказательства: video.mp4, console.log, HAR-файл приложены
Серьёзность: Critical (пользователи не могут оплатить) Приоритет: High
Вторую версию можно исправить без единого уточняющего вопроса. Ошибка в консоли даже указывает разработчику на строку кода.
Серьёзность и приоритет
Серьёзность описывает влияние дефекта на систему. Приоритет — как быстро его нужно исправить. Обычно они связаны, но не всегда, и эта разница важна при планировании.
Наш чек-лист перед нажатием «Создать»
- Воспроизведено как минимум дважды, желательно в чистой сессии
- Проверено, нет ли дубликата
- Шаги минимальны: убрано всё, что не нужно для воспроизведения
- Один баг — один репорт
- Заголовок понятен без открытия тикета
- Доказательства приложены, чувствительные данные скрыты
- Без эмоций и обвинений, только факты
После репорта
Когда баг исправлен, QA проверяет исправление в том же окружении и делает короткую регрессию вокруг него. Для повторяющихся багов мы проводим анализ первопричин: почему это произошло и какой тест, ревью или проверка поймали бы это раньше? Именно этот вопрос помогает командам не видеть один и тот же тип бага дважды.