Контент и тон

Ясность

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

Документация

• Обязательно: Начинать раздел с правила или вывода; устройство, причину и пример давать следом.
• Обязательно: Если мысль помещается в одном предложении, не растягивать её на абзац.
• Обязательно: Один раз определить термин и дальше использовать одно название для одного понятия.
• Запрещено: Смешивать правило, обоснование, исключение и пример в одном предложении.
• Рекомендуется: Использовать список для последовательности и таблицу для сравнения одинаковых свойств. Простую мысль оставлять прозой.

Тон

• Обязательно: Писать спокойно, конкретно и на равных с читателем; важное ставить в начало.
• Рекомендуется: Убирать из обычного продуктового текста шутки, хайп, восклицания и извинения без полезного действия.
• Запрещено: Обвинять пользователя или обещать результат, который продукт не гарантирует.

Действия и ссылки

• Обязательно: Писать на кнопке короткую реплику пользователя; объект добавлять, только если без него неясен результат.
• Запрещено: Писать на кнопке «Хочу», «Сохраняю» или «ОК», когда доступно точное действие или подтверждение.
• Обязательно: Называть в ссылке место назначения или результат, а не механику перехода «здесь» или «по ссылке».
• Обязательно: Заголовком называть конкретную страницу, задачу или состояние; не использовать пустые слова «Важно» и «Информация».

Поля и переключатели

• Обязательно: Лейблом называть данные, а не действие ввода: «Номер телефона», не «Введите номер телефона».
• Запрещено: Дублировать лейбл в placeholder или прятать в placeholder обязательную информацию.
• Рекомендуется: Использовать placeholder для примера или формата, если он помогает избежать ошибки.
• Обязательно: Формулировать подпись Switch как настройку, которая одинаково читается во включённом и выключенном состоянии.
• Запрещено: Прятать обязательное условие в hint или tooltip; там остаётся только дополнительный контекст.

Ошибки и состояния

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

Типографика

• Обязательно: Использовать sentence case, кавычки «ёлочки» и правильный знак для тире, диапазона и минуса.
• Запрещено: Ставить точку в конце короткого заголовка, кнопки, таба, лейбла или пункта меню.
• Обязательно: Не отделять процент от числа; число и валюту или единицу связывать неразрывным пробелом.

Сокращение документации

Текст контролов

Ошибки

Короткая типографическая памятка