Баг-репорт: steps to reproduce, expected vs actual, severity

Тема дорожной карты · Английский для IT

🔊 Словарь терминов с произношением →

Баг-репорт — самый формализованный текст в QA, и его структура на английском одинакова в Jira, GitHub Issues, Bugzilla и любом трекере. Title / Summary — одна строка, которая называет проблему, а не симптом: Checkout returns 500 when coupon code contains a space, а не Checkout is broken. Environment — где воспроизводится: версия, ОС, браузер, окружение (prod, staging), сборка (build 2026.09.28). Preconditions — что должно быть до начала: user is logged in and has one item in the cart. Steps to reproduce (STR) — нумерованные шаги, каждый с одним действием: 1. Open the cart. 2. Enter coupon "SAVE 10". 3. Click Apply. Expected result — что должно было произойти: Discount is applied, total updates. Actual result — что произошло: Page shows a 500 error, total unchanged. Frequency / Reproducibility — как часто: always, intermittent (периодически), once, 3 out of 10 attempts. Severity — серьёзность влияния: blocker (блокирует работу), critical, major, minor, trivial / cosmetic. Priority — порядок исправления: P0 / P1 / P2 или highest … lowest. Attachments — вложения: screenshot, screen recording, logs, HAR file, stack trace. Workaround — временный обход, если есть. Root cause — заполняется разработчиком. Regression? — сломалось ли то, что работало: regression since 2.3.0. Статусы: New / Open, Triaged, In Progress, Fixed, Verified / Closed, Reopened, Won't Fix, Duplicate, Cannot Reproduce / Works for me, By Design / Not a Bug, Deferred. Глаголы: to file a bug (завести), to reproduce (воспроизвести), to triage (разобрать), to assign, to escalate, to verify the fix, to reopen, to close as duplicate.

Как произносится

Bug report /bʌɡ rɪˈpɔːrt/, summary /ˈsʌməri/, environment /ɪnˈvaɪrənmənt/, preconditions /ˌpriːkənˈdɪʃənz/, reproduce /ˌriːprəˈdjuːs/, reproducible /ˌriːprəˈdjuːsəbl/, expected /ɪkˈspɛktɪd/, actual /ˈæktʃuəl/, intermittent /ˌɪntərˈmɪtənt/ («интермИтент»), severity /sɪˈvɛrəti/, priority /praɪˈɒrəti/, blocker /ˈblɒkər/, critical /ˈkrɪtɪkəl/, major /ˈmeɪdʒər/, minor /ˈmaɪnər/, trivial /ˈtrɪviəl/, cosmetic /kɒzˈmɛtɪk/, attachment /əˈtætʃmənt/, workaround /ˈwɜːrkəraʊnd/, triage /ˈtriːɑːʒ/, duplicate как существительное /ˈdjuːplɪkət/, deferred /dɪˈfɜːrd/, regression /rɪˈɡrɛʃən/, frequency /ˈfriːkwənsi/.

Как употребляется

Пример заполненного репорта:

Title: Checkout returns 500 when coupon code contains a space. Environment: prod, build 2026.09.28, Chrome 129 / macOS. Preconditions: logged-in user with one item in the cart. Steps: 1. Open /cart. 2. Enter "SAVE 10" in the coupon field. 3. Click Apply. Expected: discount applied, total updated. Actual: 500 error banner, total unchanged. Console shows TypeError: code.trim is not a function. Frequency: always. Severity: major. Priority: P1 (affects 4% of orders per analytics). Workaround: remove the space manually. Regression: yes, worked in 2026.09.21.

Фразы: I can't reproduce this on staging. — Не воспроизводится на стейдже. Could you attach the HAR file? — Приложите HAR. Closing as duplicate of #412. — Закрываю как дубликат. Works for me; what's your browser version? — У меня работает, какая версия браузера? Downgrading severity to minor: cosmetic only. — Понижаю серьёзность до minor, только косметика.

Ловушки

Первая ловушка — заголовок-симптом (Something is wrong with checkout): нужен заголовок-проблема с условием. Вторая — смешивать ожидание и факт в одном абзаце: разделы Expected и Actual существуют, чтобы разработчик за секунду увидел расхождение. Третья — шаги без нумерации или несколько действий в одном шаге: Open cart, add coupon and pay невозможно воспроизвести по шагам. Четвёртая — severity по эмоциям: blocker только если работа невозможна. Пятая — reproduce как «репродуцировать» и STR как «эс-ти-эр» без расшифровки для новичков. Шестая — Won't Fix воспринимать как оскорбление: это нормальное решение с объяснением. Седьмая — Cannot Reproduce закрывать сразу: сначала запросить окружение и запись экрана.

Связанные понятия

Полезные ресурсы