Как должен выглядеть хороший баг-репорт?

«Как должен выглядеть хороший баг-репорт?» — вопрос из категории Тестовая документация, который задают на 24% собеседований AQA / Automation. Ниже — развёрнутый ответ с разбором ключевых моментов.

Ответ

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

Обязательные поля:

  1. Заголовок (Title): Кратко и точно описывает проблему. Например: "Кнопка 'Отправить' не становится активной после заполнения всех обязательных полей формы".
  2. Шаги воспроизведения (Steps to Reproduce): Четкая, пронумерованная последовательность действий.
    1. Открыть страницу /registration.
    2. Заполнить поля: Имя, Фамилия, Email (valid-email@example.com).
    3. Поставить галочку согласия с условиями.
    4. Наблюдать за состоянием кнопки 'Отправить'.
  3. Фактический результат (Actual Result): Что происходит на самом деле. "Кнопка 'Отправить' остается серой и неактивной (disabled)".
  4. Ожидаемый результат (Expected Result): Как система должна себя вести согласно требованиям или здравому смыслу. "После заполнения всех обязательных полей и принятия условий кнопка 'Отправить' должна стать активной (clickable)".
  5. Окружение (Environment): OS: Windows 11, Browser: Chrome 125.0, Environment: Staging.

Дополнительно, для сложных багов:

  • Серьезность/Приоритет (Severity/Priority): Например, Severity: High (блокирует ключевую функциональность), Priority: P1.
  • Вложения (Attachments): Скриншоты с аннотациями, логи консоли браузера или сетевые запросы (из DevTools).
  • Ссылка на требование (Requirement Link): ID user story или пункт в спецификации.

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