{"canonical_url":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/","content_markdown":"# Переписала помилки, щоб не винити користувачів\n\nПереписала повідомлення про помилки застосунку за письмовим стандартом тону після того, як у разі відмови у вході застосунок звинувачував користувача в помилці введення, хоча провайдер насправді вимагав пароль для застосунку, і покрила це тестом, який називає провайдера.\n\nвересень 2026\n\n**Ситуація.** Вхід в обліковий запис великого поштового провайдера не вдався, і застосунок повідомив користувачеві, що пароль неправильний. Пароль був правильний. Цей провайдер вимагає для сторонніх клієнтів окремого пароля застосунку й відхиляє пароль облікового запису, хоч би як ретельно його набирали. Повідомлення змушувало користувача знову вводити те, що ніколи не могло спрацювати, а справжньої вказівки — створити пароль іншого типу — не було ніде.\n\n**Завдання.** Повідомлення про помилки треба було переписати за письмово зафіксованим стандартом, а не виправляти по одному, бо цей випадок був лише помітним проявом звички, яка проходила крізь усі повідомлення.\n\n**Дія.** Стандарт містить три вимоги: сказати, що сталося; ніколи не натякати, що користувач зробив щось не так, якщо причина в іншому; і назвати наступний крок, якщо він є. Коли стандарт застосували до всіх повідомлень про помилки, виявилося, що більшість порушує принаймні одну вимогу — кілька повідомлень були просто рядком помилки базової бібліотеки, переданим без змін, а такий рядок описує стан для програміста, а не ситуацію для людини. Повідомлення для випадку з провайдером переписали так, щоб воно називало провайдера, пояснювало, що для інших клієнтів він вимагає окремого пароля застосунку, і вказувало, де такий пароль створити. Повернутися до старого не дає тест, і він навмисно конкретний: він відтворює невдалий вхід у цього провайдера й перевіряє, що повідомлення містить назву провайдера та фразу з описом потрібного типу облікових даних. Тест, який перевіряв би лише появу якоїсь помилки, пройшов би й на початковому неправильному повідомленні, тому перевірка стосується змісту — єдиної частини, яка взагалі була зламана.\n\n**Результат.** Повідомлення про помилки відповідають сформульованому стандарту, а випадок, з якого все почалося, покрито тестом, що не проходить на старому тексті. Невирішеним лишається масштаб: дотримання стандарту забезпечують рев'ю та один тест для одного повідомлення, а для інших провайдерів з їхніми особливими вимогами аналогічних тестів немає, тож цей клас помилок задокументовано, а не закрито.\n\n---\n\n- Роль: Контент‑дизайнер\n- Категорії: [Frontend‑розробка](https://engineer.company/uk/categories/frontend/), [Безпека](https://engineer.company/uk/categories/security/), [Тестування та QA](https://engineer.company/uk/categories/testing/), [UX / UI‑дизайн](https://engineer.company/uk/categories/ux-ui/), [Продукт і вимоги](https://engineer.company/uk/categories/product/), [Документація](https://engineer.company/uk/categories/documentation/)\n- Послуги: [UI/UX‑дизайн та дизайн‑системи](https://engineer.company/uk/services/ui-ux-design/), [Продуктова стратегія та вимоги](https://engineer.company/uk/services/product-strategy/), [Технічна документація](https://engineer.company/uk/services/technical-documentation/)\n\n\u003chttps://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Повідомлення про помилки відповідають сформульованому стандарту, а випадок, з якого все почалося, покрито тестом, що не проходить на старому тексті.","formats":{"gemtext":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/index.gmi","gopher":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/gophermap","html":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/","json":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/index.json","markdown":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/index.md","pdf":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/index.pdf"},"kind":"page","language":"uk","title":"Переписала помилки, щоб не винити користувачів","url":"https://engineer.company/uk/portfolio/rewrote-error-messages-to-stop-blaming-users/","version":1}