Переписала помилки, щоб не винити користувачів
Переписала повідомлення про помилки застосунку за письмовим
стандартом тону після того, як у разі відмови у вході застосунок
звинувачував користувача в помилці введення, хоча провайдер
насправді вимагав пароль для застосунку, і покрила це тестом, який
називає провайдера.
вересень 2026

Ситуація. Вхід в обліковий запис великого поштового провайдера не
вдався, і застосунок повідомив користувачеві, що пароль
неправильний. Пароль був правильний. Цей провайдер вимагає для
сторонніх клієнтів окремого пароля застосунку й відхиляє пароль
облікового запису, хоч би як ретельно його набирали. Повідомлення
змушувало користувача знову вводити те, що ніколи не могло
спрацювати, а справжньої вказівки — створити пароль іншого типу — не
було ніде.

Завдання. Повідомлення про помилки треба було переписати за письмово
зафіксованим стандартом, а не виправляти по одному, бо цей випадок
був лише помітним проявом звички, яка проходила крізь усі
повідомлення.

Дія. Стандарт містить три вимоги: сказати, що сталося; ніколи не
натякати, що користувач зробив щось не так, якщо причина в іншому; і
назвати наступний крок, якщо він є. Коли стандарт застосували до
всіх повідомлень про помилки, виявилося, що більшість порушує
принаймні одну вимогу — кілька повідомлень були просто рядком
помилки базової бібліотеки, переданим без змін, а такий рядок описує
стан для програміста, а не ситуацію для людини. Повідомлення для
випадку з провайдером переписали так, щоб воно називало провайдера,
пояснювало, що для інших клієнтів він вимагає окремого пароля
застосунку, і вказувало, де такий пароль створити. Повернутися до
старого не дає тест, і він навмисно конкретний: він відтворює
невдалий вхід у цього провайдера й перевіряє, що повідомлення
містить назву провайдера та фразу з описом потрібного типу облікових
даних. Тест, який перевіряв би лише появу якоїсь помилки, пройшов би
й на початковому неправильному повідомленні, тому перевірка
стосується змісту — єдиної частини, яка взагалі була зламана.

Результат. Повідомлення про помилки відповідають сформульованому
стандарту, а випадок, з якого все почалося, покрито тестом, що не
проходить на старому тексті. Невирішеним лишається масштаб:
дотримання стандарту забезпечують рев'ю та один тест для одного
повідомлення, а для інших провайдерів з їхніми особливими вимогами
аналогічних тестів немає, тож цей клас помилок задокументовано, а не
закрито.

Категорії:
1Frontend‑розробка	/uk/categories/frontend/	advisory.engineer.company	70
1Безпека	/uk/categories/security/	advisory.engineer.company	70
1Тестування та QA	/uk/categories/testing/	advisory.engineer.company	70
1UX / UI‑дизайн	/uk/categories/ux-ui/	advisory.engineer.company	70
1Продукт і вимоги	/uk/categories/product/	advisory.engineer.company	70
1Документація	/uk/categories/documentation/	advisory.engineer.company	70

Послуги:
1UI/UX‑дизайн та дизайн‑системи	/uk/services/ui-ux-design/	advisory.engineer.company	70
1Продуктова стратегія та вимоги	/uk/services/product-strategy/	advisory.engineer.company	70
1Технічна документація	/uk/services/technical-documentation/	advisory.engineer.company	70

hЦя сторінка у вебі	URL:https://advisory.engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/	advisory.engineer.company	70
