Проверка текста подсказки и шага тура

Подсказку читают между делом: человек пришёл в продукт решать свою задачу, а не читать. Поэтому у каждого формата есть бюджет внимания. Инструмент использует такие редакционные нормы:

Превышение до 30 % — совет, больше — ошибка. Это не научный стандарт, а практика: такие ограничения мы используем в шаблонах Clew. Время чтения считается по скорости 184 слова в минуту — средней для русского текста в исследовании IReST; подробнее — в проверке читаемости текста.

• Канцелярит. «В целях», «в рамках», «данный», «осуществить», «необходимо» — удлиняют фразу и отдаляют от человека. Для каждого найденного оборота есть замена. Полный список с примерами до и после — в статье «Канцелярит: что это и как убрать».
• Безличные и пассивные обороты. «Отображается список», «данные были сохранены» — непонятно, кто действует. В интерфейсе лучше прямо: «мы сохранили», «добавьте».
• Кнопка. Хорошая кнопка начинается с глагола и называет результат: «Создать проект» вместо «ОК». Размытые надписи — «ОК», «Подробнее», «Нажмите здесь» — отмечаются.
• Обращение. «Вы» и «ты» не смешиваются; «вы» в интерфейсе пишется со строчной буквы.
• Восклицательные знаки и капслок. Воспринимаются как крик и отвлекают от сути.
• Числа словами и жаргон. «Три шага» → «3 шага»; «фича», «юзер», «кликнуть» — не всем пользователям понятны.

Проверки словаря — эвристики: морфологию русского языка правилами не описать без ошибок. Если инструмент отметил нормальную фразу, оставьте её.

1. Одна подсказка — одно действие. Если нужно объяснить три вещи, это тур из трёх шагов или чеклист.
2. Начинайте с пользы или действия. «Добавьте коллег, чтобы назначать задачи» лучше, чем «В этом разделе вы можете управлять пользователями».
3. Заголовок — суть, текст — подробность. Многие читают только заголовок.
4. Кнопка называет результат. «Пригласить коллег», «Создать первый отчёт».
5. Показывайте в момент, когда это нужно. Даже идеальный текст не сработает, если подсказка появилась до того, как человек дошёл до задачи.

Больше примеров — в статьях «Чеклист онбординга» и «Примеры онбординга в SaaS».

1. Галь Н. Слово живое и мёртвое. Первое издание — 1972 — о канцелярите.
2. Ильяхов М., Сарычева Л. Пиши, сокращай. М.: Альпина Паблишер, 2016.
3. Оборнева И. В. Автоматизированная оценка сложности учебных текстов на основе статистических параметров: дис. … канд. пед. наук. М., 2006.
4. Trauzettel-Klosinski S., Dietz K., IReST Study Group. Standardized Assessment of Reading Performance: The New International Reading Speed Texts IReST. IOVS, 53(9), 2012.
5. Nielsen Norman Group. Tooltip Guidelines; How Users Read on the Web — nngroup.com.