Меню
Поиск

Текст в интерфейсе · Тексты ошибок и пустых состояний

Как навести порядок в системных сообщениях продукта: одна сводка, одна формулировка на ситуацию, схема и проверка до выката

Сообщения о сбоях, отказах и пустых экранах пишут в разное время разные люди, и одна ситуация звучит в продукте пятью способами. В уроке разберём, где искать все системные сообщения и как собрать их в сводку, как свести одинаковые ситуации к одной формулировке и не склеить разные, какую схему держать для нового сообщения, о чём договориться с разработкой — ключи, коды сервера, формы множественного числа — и как проверять сообщения до выката, а не после жалоб. Для практики — сообщения «Лесной обжарки»: тренажёры и разбор сводки от разработки.

Пример для всего урока. «Лесная обжарка» выросла: сайт, приложение, письма, СМС и пуш-уведомления. Системные сообщения в них писали в разное время разные люди — разработчики сайта и приложения, поддержка, а часть текстов приходит готовой от платёжного сервиса. Покупатель без связи видит в приложении «Нет подключения», на сайте — «Network Error», а письмо о неоплаченном заказе сообщает, что «платёж не прошёл по техническим причинам». Урок о том, как собрать это в общие правила. Правила тона и общий словарь продукта разобраны в уроке «Формулировки интерфейса», Senior, словарь ошибок у полей формы — в уроке «Формы», Senior. Здесь — сообщения о сбоях, отказах, пустых экранах и ограничениях.

1Сводка всех сообщений продукта

Пока сообщения разбросаны по коду, письмам и шаблонам поддержки, дубли не видны. Первый шаг — собрать их в одну таблицу.

Сообщения прячутся в местах, куда дизайнер обычно не заглядывает.

Многих из них в макетах нет: их писали сразу в коде или получали готовыми со стороны.

Где искатьЧто тамКак достать
Файлы строк сайта и приложенияТексты, уже вынесенные из кода по ключамПопросить у разработки выгрузку
КодТексты, вписанные прямо в код, и ответы сервера, которые экран показывает как есть: «Order not found»Пройти поиск по коду вместе с разработчиком; пройти сценарии, вызывая ошибки
Платёжный сервисОтказы банка, которые приходят готовой фразойВызвать отказы тестовыми картами платёжного сервиса
Письма, СМС, пушНеоплаченный заказ, отмена, задержка доставкиШаблоны у маркетинга или в сервисе рассылок
Шаблоны поддержкиОтветы на «где заказ» и «не прошла оплата»У старшего в поддержке
Обращения покупателейСнимки экранов с ошибками, которых нет нигде большеПоиск по обращениям: «ошибка», «не работает», «пусто»

Как устроена сводка

В сводке одна строка — один текст в одном месте.

Главная колонка — «что случилось в системе». Её заполняют словами разработчика, а не текстом сообщения.

Без неё дубли не найти: одна ситуация прячется за разными словами.

Например, вот как выглядит в сводке «Лесной обжарки» одна ситуация — у телефона или компьютера нет связи.

Где появляетсяТекст сейчасЧто случилось в системе
Приложение, корзина«Нет подключения к интернету»Нет связи
Приложение, заказы«Проверьте соединение и повторите попытку»Нет связи
Сайт, оплата«Network Error»Нет связи
Сайт, каталог«Не удалось загрузить данные»Нет связи
Приложение, подписка«Что-то пошло не так»Нет связи

Пять текстов на одну ситуацию — для покупателя это пять разных проблем. А в последней строке ещё и общая фраза там, где приложение точно знает причину.

Сначала собрать, потом оценивать

В Nielsen Norman Group такой список называют инвентаризацией контента: полный перечень того, что есть, с признаками каждого куска.

Оценка — что исправить, что убрать, чего не хватает — это следующий шаг, аудит.

Их стоит не смешивать. Если оценивать по ходу сбора, сводка выйдет неполной, а дубли так и останутся незамеченными.

Сначала собрать всё, потом оценивать. Одна строка — один текст в одном месте, с колонкой «что случилось в системе». Дубли видны только по этой колонке.

2Одна ситуация — одна формулировка

Сводку группируют по ситуации, а не по экрану. Ситуация — это что случилось с делом человека и кто это исправит, а не где он это увидел.

Пять текстов про связь сводятся к одному, с местом для подробностей:

«Нет связи с интернетом. [Что] сохранено — [что сделать], когда связь появится».

Например:

  • в корзине — «Корзина сохранена — оформить заказ можно, когда связь появится»;
  • в отзыве — «Отзыв сохранён — отправить можно, когда связь появится».

Формулировка одна, детали по месту. Так же устроен словарь ошибок полей в уроке про формы: шаблон с подстановкой и пример.

Две ловушки

Сводя тексты, легко ошибиться двумя способами.

ЛовушкаПримерЧто делать
Разные слова, одна ситуация«Нет подключения», «Network Error», «Проверьте соединение» — всё это нет связиСвести к одной формулировке
Одни слова, разные ситуации«Не удалось загрузить» и когда нет связи, и когда не отвечает сервер магазинаРазвести: в первом случае исправит связь, во втором — магазин. Тексты разные

Вторая ловушка опаснее первой. Синонимы видно в сводке сразу, а одинаковые слова для разных ситуаций выглядят как порядок.

Проверка — вопрос из урока Middle: кто исправит? Если ответы разные, ситуации разные.

Проверьте себя

Восемь пар сообщений из сводки. Одна это ситуация или две?

Тренажёр · одна ситуация или две
  1. «Нет подключения к интернету» в приложении и «Network Error» на сайте — оба при отключённой связи.

  2. «Не удалось загрузить» при отключённой связи и «Не удалось загрузить», когда не отвечает сервер магазина.

  3. «Сессия истекла» после получаса без действий и «Вы вышли из аккаунта» после выхода на другом устройстве.

  4. «Промокод недействителен», когда срок вышел, и «Промокод недействителен», когда в нём опечатка.

  5. «Товар закончился» в корзине и «Нет в наличии» на карточке сорта.

  6. «Банк отклонил платёж» на сайте и «Оплата не прошла» в письме о неоплаченном заказе — оба после отказа банка.

  7. «Страница не найдена» по старой ссылке на сорт и «Заказ не найден» по пересланной ссылке на чужой заказ.

  8. «Сервис временно недоступен» на сайте и «Технические работы» в приложении во время одного планового обновления.

Ситуация одна, если совпадает и что случилось, и кто это исправит. Совпадение слов ничего не значит.
Ситуации группируют по тому, что случилось и кто исправит. Одна ситуация — одна формулировка с местами для подробностей. Разные ситуации не прячутся за одинаковыми словами.

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

3Схема сообщения

Схема — порядок частей, который держат все сообщения продукта. С ней новое сообщение пишется по шаблону, а не с нуля, и разработчик может написать его сам.

Частей четыре: что случилось, почему, что цело, что делать.

В руководстве Microsoft по сообщениям об ошибках схема та же, только из трёх частей: проблема, причина, решение.

Четвёртая часть, «что цело», есть в схеме Wix. Там её называют «успокоить»: сказать, на что сбой не повлиял, например сохранён ли черновик. Это первый вопрос человека после сбоя.

Отсылать человека в поддержку Microsoft не советует вовсе. В магазине с живой поддержкой это честный последний выход, и запасной текст урока его оставляет.

ЧастьГде стоитПравилоПример
Что случилосьЗаголовокЧто не получилось с делом человека, два-четыре слова«Вход закончился»
ПочемуТекстТолько если причина меняет решение человека или снимает тревогу«Прошло 30 минут без действий»
Что целоТекстДанные и деньги — если это известно наверняка«Корзина и адрес сохранены»
Что делатьКнопка, иногда и текстДействие, которое решает проблему отсюда«Войти и продолжить»

Когда писать причину

«Почему» — самая спорная часть схемы.

«Из-за технической ошибки» и «по техническим причинам» причину не называют, а только занимают место.

Другое дело — «сбой на нашей стороне». Причины это тоже не называет, но говорит, кто исправит, и снимает вопрос «что я сделал не так». В Wix так пишут нарочно.

«Прошло 30 минут без действий» — называет. Человек понимает, что его не взломали, и знает, как этого избежать.

Пишите причину, если после неё человек поступит иначе или успокоится. Иначе пропускайте.

Длина частей

Atlassian добавляет к частям сообщения длину:

  • заголовок — три-четыре слова;
  • текст — одно-два предложения;
  • кнопка — одно-два слова.

И советует не выдумывать причину, если её нет: сказать, что что-то не получилось, и предложить, что делать. Так устроен запасной текст для неизвестной ошибки из урока Junior.

Схема в разных формах

Схема — не одна форма на все случаи.

Сообщение может быть строкой у поля, всплывающей строкой, плашкой или окном. В каждое помещается своя часть схемы.

ГдеЧто из схемы помещаетсяПример
Строка у поляЧто поменять — по словарю ошибок форм«Промокод действовал до 30 сентября»
Всплывающая строкаЧто случилось и кнопка«Не удалось добавить в избранное · Повторить»
ПлашкаСостояние, которое длится, и что цело«Нет связи. Корзина сохранена»
На месте спискаВсе части«Заказы не загрузились. Сервер магазина не отвечает, история на месте» и «Обновить»
ОкноВсе части и выбор из двух действий«Кения АА закончилась. Оформить заказ без неё?» — «Оформить без Кении» и «Вернуться в корзину»

Соберите сообщение по схеме

Проверьте схему на сообщении разработчика.

Покупатель полчаса выбирал сорта и вернулся к оформлению, а вход в аккаунт закончился. Разработчик выбрал первые варианты.

Тренажёр · соберите сообщение по схеме
←Оформление заказа
Вход закончилсяПрошло 30 минут без действий.Корзина и адрес доставки сохранены.Войти и продолжить
Заголовок — что случилось

Не по схеме. «Сессия» — слово разработки. Покупатель не знает, что это, и не понимает, что с ним случилось.

По схеме. Что случилось с делом покупателя, два слова.

Не по схеме. Код и слово разработки. Код, если нужен поддержке, ставят после текста.

Почему

Не по схеме. Причину не называет и звучит так, будто покупатель что-то нарушил.

По схеме. Причина снимает тревогу — аккаунт не взломали — и объясняет, как этого избежать.

Не по схеме. Здесь причина меняет дело: без неё покупатель может решить, что его выкинули из аккаунта посторонние.

Что цело

Не по схеме. Пугает и не говорит, что именно пропало. А корзина и адрес как раз сохранены.

Не по схеме. Это не о данных, а действие, да ещё словом разработки. Действие — на кнопке.

По схеме. Ответ на первый вопрос: полчаса выбора не пропали.

Кнопка — что делать

Не по схеме. Закрывает окно, а войти покупатель должен догадаться сам.

Не по схеме. Уводит от заказа. После входа покупатель будет искать корзину заново.

По схеме. Действие и обещание вернуть к оформлению — то, что разобрано в уроке Middle.

Схема проверяется так: закройте заголовок и прочтите только кнопку. Если понятно, что будет, — кнопка по схеме.
Схема одна на продукт. Что случилось — в заголовке, почему — если меняет решение, что цело — если известно, что делать — на кнопке. Короткое сообщение берёт из схемы меньше частей, но порядок не меняет.

4Где живут тексты и кто их меняет

Схема ничего не даст, если тексты вписаны в код в двадцати местах. Договориться с разработкой, где лежат тексты и кто их меняет, — часть работы над сообщениями, а не её продолжение.

Договорённость обычно сводится к пяти пунктам.

ПунктКакЗачем
Тексты в одном местеФайл строк или таблица, у каждого текста ключПравка текста — одна строка, а не поиск по коду
Ключ — по ситуации, а не по экрануerror.offline, payment.declined, а не cart.error1Одна ситуация автоматически звучит одинаково везде
Сервер отдаёт код ситуации, текст выбирает приложение«Order not found» с сервера на экран не попадаетТекст пишет тот, кто отвечает за слова, и на языке покупателя
Запасной текст для неизвестного кодаОдин на продукт, с кодом для поддержкиНовая ошибка сервера не превращается в пустое окно или английскую фразу
Числа — через формы множественного числаСтрока с вариантами для 1, 2 и 5Не будет «Осталось 1 попыток»

Цена общего ключа

Правка общего ключа меняет текст сразу на всех экранах.

Команда интернационализации Яндекса поэтому делает наоборот. Ключ там строится из текста. Одинаковым текстам в разных местах советуют давать разные ключи, чтобы правка не задела то, чего не собирались менять.

Тогда единообразие держит сводка, а не ключ.

Тексты, которые нужно менять без выпуска приложения, там держат на сервере. Но пишет их всё равно тот, кто отвечает за слова.

Довод для разработки

Третий пункт — сервер отдаёт код, текст выбирает приложение — разработчики знают и без дизайнера.

Стандарт RFC 9457 описывает, как сервер сообщает об ошибке: тип проблемы, короткий заголовок, подробности.

Заголовок не меняется от случая к случаю, кроме перевода. А подробностям, как советует сам стандарт, лучше помогать исправить проблему, а не отлаживать сервер.

Это хороший довод в разговоре с разработкой: даже сервер говорит о деле, а не о своём устройстве.

Руководство Microsoft требует того же от всей программы: у каждой проблемы свой код. Хорошее сообщение — задача не только интерфейса, но и устройства программы.

Тексты платёжного сервиса

С ними сложнее. Stripe пишет, что его тексты об ошибках карты можно показывать покупателям.

Но они на английском, в своём тоне и с другой схемой. Надёжнее держать у себя свой текст на каждый код отказа банка, а текст сервиса использовать как запасной.

Числа в текстах

С числами в русском языке легко ошибиться: форм у числа три, а не две, как в английском.

Правила языков собраны в справочнике Unicode CLDR. Для русского:

  • «одна» — 1, 21, 31, но не 11;
  • «несколько» — 2–4, 22–24, но не 12–14;
  • «много» — 0, 5–20, 25–30;
  • отдельная форма — для дробей: «из 1,5 книги».

Программисты пишут такие строки в формате ICU MessageFormat. Вместо знака # подставляется само число:

{count, plural,
  one {Осталась # попытка}
  few {Осталось # попытки}
  many {Осталось # попыток}
  other {Осталось # попытки}}

Если форм в продукте не завели, есть обходной путь, который советует документация Android: формулировка, где число не согласуется со словом. Например:

«Попыток осталось: 1» читается чуть суше, но без ошибки при любом числе.

Кто решает и кто меняет

ЧтоКто решаетКто меняет
Текст сообщенияДизайнер или редакторЛюбой, но через сводку и с проверкой дизайнера
Ключ и где сообщение показываетсяРазработчикРазработчик
Когда сообщение показывается: условие и порогВместеРазработчик
Новая ситуацияДизайнер заводит строку в сводкеРазработчик заводит ключ
Текст отдельно от кода, ключ — по ситуации. Сервер отдаёт код, приложение выбирает текст, для неизвестного кода есть запасной. Кто решает текст и кто его меняет — записано, а не помнится.

5Проверка до выката

Новое сообщение проверяют, пока оно в задаче, а не тогда, когда о нём пишут в поддержку.

Сообщения об ошибках попадают в продукт тише остальных текстов: их добавляют вместе с обработкой ошибки, часто без макета. Поэтому проверку встраивают в ту дорогу, по которой код идёт к покупателю.

КогдаЧто проверяютКто
В задаче на экранСписок ошибок и пустот экрана — до вёрстки, по шаблону из урока MiddleДизайнер
Когда появилось новое сообщениеЕсть ли его ситуация в сводке. Есть — берут ключ. Нет — сначала строка в сводке, потом ключРазработчик, вопрос — дизайнеру
При проверке кода перед слияниемИзменения в файле строк: каждый новый или правленый текст по схемеДизайнер или редактор
Автоматически при каждой сборкеЗапретные слова и формы: «некорректн», «Ошибка 500», «Что-то пошло не так» без продолженияСкрипт
Перед выкатомСценарии с вызванными ошибками: без связи, с подставным сервером, с тестовыми картами отказаТестировщик и дизайнер

Автоматическая проверка

Она ловит только то, что можно описать списком. Но этого уже немало.

Для текстов есть готовые инструменты. Например, Vale проверяет текст по правилам, как программы проверяют код. Одно из его правил ищет в тексте слова и выражения из заданного списка.

GitLab проверяет им свою документацию прямо при сборке, и ошибки уровня error её останавливают.

Для файла строк продукта хватит и короткого скрипта. Главное, чтобы список запретов был записан и проверялся сам.

Проверка через месяц

В Wix после большой правки сообщений завели ещё одну плановую проверку — через месяц после запуска.

В новом продукте заранее не известно, какие ошибки станут частыми, и тексты для них дописывают по факту. Это не проверка после жалоб: дату назначают заранее.

Проверьте себя

Восемь сообщений пришли на проверку перед выкатом. Пропустить или вернуть?

Тренажёр · пропустить или вернуть
  1. Новый ключ checkout.offline: «Нет связи с интернетом. Корзина сохранена — оформить заказ можно, когда связь появится». В сводке уже есть error.offline с местом для подробностей.

  2. «Подарочную подписку нельзя оплатить картой иностранного банка. Оплатите российской картой или через СБП». Ситуации в сводке нет, по схеме всё есть.

  3. «Осталось {n} попыток» без форм множественного числа.

  4. На экран подписки выводится ответ сервера как есть: «SUBSCRIPTION_PAUSED».

  5. «Доставка 14 октября недоступна: курьеры заняты. Ближайший свободный день — 15 октября». Кнопка «Выбрать 15 октября».

  6. «Упс! Что-то сломалось. Попробуйте позже».

  7. Запасной текст для неизвестного кода: «Не получилось: {действие}. Данные на месте — попробуйте через пару минут. Если не выйдет, напишите в поддержку и назовите код {код}».

  8. «Вы ввели неверный код подтверждения».

Возвращают с причиной — номером правила или строкой сводки. Тогда возврат учит, а не раздражает.
Сообщение проверяют на дороге к покупателю. Ситуация — в сводке до ключа, текст — на проверке кода, запреты — скриптом при сборке, сценарии с ошибками — перед выкатом.

6Разберите сводку от разработки

Разработчик собрал десять ключей приложения в таблицу и прислал на проверку перед выкатом. Пять строк нарушают правила урока.

Нажимайте на строки, которые вы бы вернули. Нормальные тоже можно нажать.

Сводка сообщений · найдите нарушения
КлючТекстГде
error.offlineНет связи с интернетом. {Что} сохранено — {что сделать}, когда связь появится.Все экраны cart.network_errorПроверьте соединение и повторите попытку.Корзина payment.declinedБанк не подтвердил оплату. Деньги не списаны — оплатите другой картой или узнайте причину в банке.Оплата, письмо orders.load_failedНе удалось загрузить заказы. Проверьте подключение к интернету.Мои заказы, при сбое сервера session.expiredВход закончился: прошло 30 минут без действий. Корзина и адрес сохранены.Все экраны promo.invalidПромокод недействителен.Оформление: опечатка и истёкший срок delivery.day_unavailableДоставка {дата} недоступна: курьеры заняты. Ближайший свободный день — {дата}.Оформление subscription.pausedSUBSCRIPTION_PAUSEDПодписка error.unknownНе получилось: {действие}. Данные на месте — попробуйте через пару минут. Если не выйдет, напишите в поддержку и назовите код {код}.Все экраны login.attempts_leftОсталось {n} попыток.Вход
  1. error.offline.Оставить. Общий ключ ситуации с местами для подробностей — то, к чему сводятся все тексты про связь.
  2. cart.network_error.Вернуть. Дубль error.offline другими словами и с ключом по экрану. Корзина должна брать общий ключ с подстановкой «Корзина».
  3. payment.declined.Оставить. Кто отказал, что с деньгами, два выхода. Один ключ и для экрана, и для письма.
  4. orders.load_failed.Вернуть. Текст про связь стоит на сбое сервера: покупатель будет проверять интернет, который в порядке. Нужна своя ситуация: «Заказы не загрузились. Сервер магазина не отвечает, история на месте».
  5. session.expired.Оставить. Что случилось, почему и что цело — по схеме.
  6. promo.invalid.Вернуть. Один текст на две ситуации: опечатку человек исправит, истёкший срок — нет. Два ключа: «Промокода {код} нет — проверьте, нет ли опечатки» и «Промокод {код} действовал до {дата}».
  7. delivery.day_unavailable.Оставить. Причина и ближайший выход. Ключ назван по ситуации.
  8. subscription.paused.Вернуть. Вместо текста — код ситуации с сервера. Нужен текст: «Подписка на паузе до {дата}».
  9. error.unknown.Оставить. Запасной текст для неизвестного: что не получилось, что цело, что делать и код для поддержки.
  10. login.attempts_left.Вернуть. Без форм множественного числа выйдет «Осталось 1 попыток». Нужны формы для 1, 2 и 5 или «Попыток осталось: {n}».

Все пять найдены. Дубль с ключом по экрану, текст про связь на сбое сервера, один текст на две ситуации, код вместо слов и число без форм. Ни одно из этих нарушений не видно в макете — только в сводке.

Нормальные строки тоже можно нажать: вы прочитаете, почему там всё в порядке, а счётчик «Найдено» не изменится.
Сводку проверяют целиком, а не по одной строке. Дубль и одинаковые слова для разных ситуаций видно только рядом с остальными строками.

7Задание

Сведите системные сообщения своего продукта в один список, вычистите дубли и опишите схему, по которой пишется новое сообщение.

Часть 1 · Собрать, 2 часа

  1. Возьмите один сценарий целиком, если продукт большой: оформление заказа, регистрацию, оплату. Весь продукт за один заход не собрать.
  2. Пройдите все источники из таблицы раздела 1: файлы строк, код, платёжный сервис, письма и СМС, шаблоны поддержки, обращения.
  3. Заполните колонку «что случилось в системе» вместе с разработчиком. Это самая долгая и самая полезная часть.
Сводка и схема сообщений
ПРОДУКТ / СЦЕНАРИЙ: ______________________   Дата: __.__.____
ВЛАДЕЛЕЦ СВОДКИ: ______________________

СВОДКА · одна строка — один текст в одном месте
где | канал | текст сейчас | что случилось в системе | кто исправит | ключ
____ | ____ | ____ | ____ | ____ | ____

СИТУАЦИИ ПОСЛЕ СВЕДЕНИЯ
ситуация: ____________   было текстов: __
формулировка: ______________________
ключ: ____________   подстановки: ____________

СХЕМА СООБЩЕНИЯ
заголовок — что случилось: ____________
текст — почему (если меняет решение), что цело: ____________
кнопка — что делать: ____________
запасной текст для неизвестного кода: ______________________
не пишем: ______________________

ДОГОВОРЁННОСТЬ С РАЗРАБОТКОЙ
где лежат тексты: ____________   ключ — по ситуации: да / нет
кто решает текст: ____________   кто меняет: ____________
новая ситуация: сначала строка в сводке, потом ключ
проверка до выката: ______________________
Колонка «кто исправит» нужна, чтобы не склеить разные ситуации с одинаковыми словами.

Часть 2 · Свести и описать схему, 2 часа

  1. Сгруппируйте строки по ситуации и для каждой выберите одну формулировку с местами для подробностей.
  2. Проверьте вторую ловушку: одинаковые тексты с разными ответами в колонке «кто исправит» разведите.
  3. Опишите схему на одной странице: части, где каждая стоит, что не пишем, запасной текст.
  4. Запишите договорённость с разработкой: где тексты, кто решает, как появляется новая ситуация.

Часть 3 · Проверить, 1 час

  1. Дайте схему разработчику и попросите написать сообщение для ситуации, которой в сводке нет.
  2. Сравните с тем, что написали бы сами. Расхождения — места, где схема недосказана; допишите её.
Как понять, что задание выполнено. Новое сообщение написано разработкой по схеме и не потребовало вашей правки.

Что должно получиться

  • Сводка одного сценария или всего продукта, с колонкой «что случилось в системе».
  • Список ситуаций с формулировками: сколько было текстов, сколько стало.
  • Схема на одной странице и записанная договорённость с разработкой.
  • Сообщение, написанное разработчиком по схеме, рядом с вашим вариантом.

План работы: 2 часа собрать, 2 — свести и описать, 1 — проверить. Полдня на один сценарий.

Частые сложности

  • «Текстов сотни». Начните с одного сценария, где ошибки стоят денег: оформление и оплата. Внутри сценария очередь — по тому, как часто ошибка случается и мешает ли она закончить дело. Так расставлял правки Wix, когда поиск по ключам нашёл 7643 сообщения. Остальное — по мере правок.
  • «Разработка не хочет выносить тексты из кода». Начните с новых: каждое новое сообщение — сразу по ключу. Старые переедут при первой правке.
  • «Сервер отдаёт только текст, без кода». Запишите это в договорённость как задачу: экрану нужен код ситуации, чтобы выбрать свой текст.
  • «Через полгода сводка устареет». Если новая ситуация сначала попадает в сводку, а потом в код, сводка обновляется сама. Владелец сводки проверяет это на проверке кода.

8Чек-лист и ошибки ступени

Сообщения продукта в порядке, если

  • Есть сводка с колонкой «что случилось в системе» и владельцем
  • Одна ситуация — одна формулировка с местами для подробностей
  • Одинаковые слова не стоят на ситуациях с разными ответами «кто исправит»
  • Схема описана: что случилось, почему, что цело, что делать — и где стоит каждая часть
  • Тексты лежат отдельно от кода, ключи названы по ситуации
  • Сервер отдаёт код, текст выбирает приложение, для неизвестного кода есть запасной текст
  • Числа в текстах — с формами множественного числа или в нейтральной формулировке
  • Новое сообщение проходит сводку, проверку кода и автоматическую проверку до выката

Что мешает

  • Ключ по экрану. Одна ситуация расходится на столько формулировок, сколько экранов.
  • Ответ сервера на экране как есть. Покупатель читает «SUBSCRIPTION_PAUSED».
  • Одни слова на разные ситуации. Совет «проверьте связь» при упавшем сервере.
  • Схема в голове у дизайнера. Разработчик пишет сообщения так, как получится.
  • Проверка после жалоб. Плохое сообщение месяц живёт у покупателей.

9Три ступени темы целиком

Тема пройдена от одного сообщения до правил для всего продукта. Сначала — писать ошибку и пустой экран так, чтобы было ясно, что делать. Потом — разводить пустоты и писать под того, кто исправит. Теперь — собирать всё в сводку, схему и договорённость с разработкой.

СтупеньЧто нужно уметьКак проверить результат
Junior Говорить, что случилось, словами человека; давать следующий шаг и кнопку; не винить; не писать общую фразу, когда причина известна; отличать пустой экран новичка от пустого поиска В каждом сообщении есть ответ на вопрос «и что мне теперь делать»
Middle Разводить четыре пустоты: ещё нет, не найдено, нет доступа, сломалось; писать текст и действие для каждой; отличать исправимую ошибку от неисправимой; говорить про сбой честно и коротко; возвращать человека туда, куда он шёл По тексту пустого экрана видно, какая именно это пустота
Senior — этот урок Собирать сообщения продукта в один список; сводить одинаковые ситуации к одной формулировке; держать схему сообщения; договариваться с разработкой, где живут тексты; проверять новые сообщения до выката Новое сообщение написано разработкой по схеме и не потребовало правки
Ориентир по этой теме: про любое сообщение своего продукта вы можете сказать, к какой ситуации оно относится, где лежит его текст и кто его менял последним.

Что почитать дальше

  • Будьте другом своему пользователю, пишите осмысленные сообщения об ошибкахХабр, перевод статьи Дженни Надлер (Wix), 2022 · на русском · бесплатноКак Wix за месяц переписал тысячи сообщений об ошибках: поиск ключей в CMS, разбор каждого сообщения с разработчиками, очередь по частоте, проверка через месяц после запуска, и схема сообщения с частью «успокоить». В отличие от урока, Wix называет причину, даже если это просто техническая ошибка: «проблема на нашей стороне».
  • Как мы создали UI-kit состояний интерфейса и «навели порядок» в продуктеХабр, Клаудмастер, 2025 · на русском · бесплатноОпыт FinOps-платформы: тосты, экраны ошибок, пустые и загрузочные состояния собраны в один набор с чек-листами текста и условиями показа, по шагам от сбора до проверки на дизайн-ревью. В примерах «стало» остались слова, которые урок вернул бы: «Ошибка аутентификации», «Ссылка некорректная».
  • Интернационализация от i до n: как мы переводим интерфейсы в Фантехе ЯндексаХабр, Александр Поляков, Яндекс, 2023 · на русском · бесплатноКоманда интернационализации Яндекса о строках интерфейса: формат ICU с формами множественного числа и подстановками, код как источник правды, линтеры при сборке. В отличие от урока, ключи там генерируются из текста, а автор в ответах читателям советует давать одинаковым текстам в разных местах разные ключи.
  • ОшибкиCentral Design System, B2B-Center · на русском · бесплатноРаздел «Ошибки» дизайн-системы B2B-Center: виды уведомлений об ошибке, правила проверки полей и таблица готовых формулировок для частых случаев, от 404 до потери связи. Материал для разбора: часть формулировок урок вернул бы — код в заголовке, «Попробуйте позже» без срока, «Неверный пароль», ошибки 500, 502 и 503 словами сервера.
  • An Error Messages Scoring RubricNielsen Norman Group, Тим Нойзессер и Эван Санволл, 2023 · на английском · бесплатноРубрика NN/g для оценки сообщений об ошибках: двенадцать правил в трёх группах — заметность, язык, экономия усилий, у каждого четыре уровня и итоговая оценка от A до D. Таблица скачивается в Excel, разобраны три примера. Подходит для аудита после сводки; единообразие сообщений между собой она не проверяет.
  • Error Messages in Windows 7Microsoft, руководство для Windows 7 · на английском · бесплатноРуководство Microsoft времён Windows 7: схема «проблема, причина, решение», раздел о том, что хорошему сообщению нужен свой код на каждую причину, правила для неизвестных ошибок и шаблоны заголовков. Примеры устарели. В отличие от урока, советует не отсылать в поддержку и писать incorrect вместо invalid.