Ошибки

Назовите, что не получилось и как это исправить, рядом с полем. Никогда не вините читателя.

Сначала предотвратите ошибку

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

Как писать сообщение

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

По-русски сообщение под полем из примера: «Введите корректный адрес почты».

<tk-field label="Email" error="Enter a valid email address">
  <tk-input type="email" value="mike@thykes"></tk-input>
</tk-field>

Рядом с полем

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

Ошибка или предупреждение

Ошибка значит: что-то сломано и требует действия, прежде чем читатель сможет продолжить.
Предупреждение значит: читатель может продолжить, но должен знать последствие.

Не оформляйте одно как другое.

Общие строки

Поведение конкретное, текст общий. Не встраивайте в строку настоящие имена и названия файлов: это ломает перевод. Берите пользовательский текст в кавычки: «Удалить „Футболка с котом“?».

Ошибки по уровням

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

Как надо и как не надо

✅ Так	❌ Не так
«Введите корректный адрес почты»	«Неверный ввод»
«Не удалось провести платёж. Карта отклонена. Попробуйте другую карту.»	«Что-то пошло не так»
«Выберите дату начала»	«Недопустимый временной параметр»
«Не больше 64 символов»	«Слишком длинно»