Текст в интерфейсе

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

Здесь собраны рекомендации как написать хороший текст для интерфейса.

Текст, как любой контрол, должен выполнять полезное действие

Текст — элемент интерфейса, как кнопка или поле ввода. Он помогает решить интерфейсную задачу: объясняет непонятное и убеждает выполнить нужное действие. В интерфейсе ни одно предложение не появляется просто так. Уберите текст, если он не выполняет работу.

Пишите кратко

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

Пишите просто

Если каждое предложение в тексте сложносочиненное и состоит из нескольких простых, то пользователь не справится, а текст не выполнит задачу. Пишите проще.

Пишите убедительно

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

Этот гайд основан на принципах инфостиля, который описал Максим Ильяхов. Спасибо ему за это.

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

Советы и учебник «Информационный стиль» на сайте Бюро Горбунова,

Посты в его блоге,

Продвинутая рассылка Главреда. С домашними заданиями и без,

Книга «Пиши, сокращай», в соавторстве с Людмилой Сарычевой.

В предложении есть подлежащее и сказуемое

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

Что почитать по теме:

«Страдательный залог: когда он нужен и не нужен»

«Хорошее и плохое подлежащее»

Подлежащее и сказуемое стоят рядом

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

Перенесите главное в начало предложения

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

Замените модальные глаголы на нормальные

Модальный глагол — слабый глагол, смысл которого раскрывается следующим за ним словом. Чтобы избавиться от модальности, возьмите отглагольное существительное, которое идет за ним, и образуйте от него глагол.

Текст с нормальными глаголами получается короче и звучит увереннее. Иногда модальным глаголам сложно найти замену, например, «был», «есть» и «будет» можно оставить в тексте.

Не используйте пассивный залог

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

Что почитать по теме:

«Как уйти от безличного повествования»

«Если действующие лица неизвестны»

Не используйте текст в скобках

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

В остальных случаях текст в скобках не нужен. Он либо точнее того, что перед скобками, либо менее точен, либо самостоятельная мысль. Если текст в скобках лучше раскрывает мысль, выкиньте текст, который стоял перед скобками:

Если текст в скобках хуже раскрывает мысль, уберите его:

Если текст в скобках — самостоятельная мысль, выделите ее в отдельное предложение:

Точка с запятой в предложении — признак слишком сложного синтаксиса

Замените причастие на нормальный глагол

Причастие — это глагол с признаками прилагательного, оно сложнее и слабее обычного глагола. Кроме того, причастие не стоит само по себе, а образует причастный оборот и этим усложняет синтаксис.

Заменили причастие на нормальный глагол, сразу и действующее лицо появилось.

Что почитать по теме

«Отглагольное»

«Вложенные и причастные обороты»

Замените деепричастие на нормальный глагол

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

Что почитать по теме:

«Отглагольное»

«Вложенные и причастные обороты»

Не ставьте в предложение больше трех однородных членов подряд и больше двух рядов однородных членов

После третьего однородного члена читатель перестает их запоминать. Три ряда по три однородных члена в каждом так же плохо, как один ряд с пятью-шестью однородными членами.

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

Один однородный член  отсутствие однородных членов помогает автору выделить главное, а читателю — понять, о чем сейчас пойдет речь.

Что почитать по теме:

«Однородные члены»

«Как сокращать однородные члены»

«Вложенные однородные члены»

Вереницы существительных в родительном падеже запрещены

«Друг подруги тёлки брата» — это сложно для понимания. Попробуйте «размотать» эту цепочку. Упростите или разделите на два предложения.

Эмоции в интерфейсе уместны вне проблемных ситуаций, рутинных или критических действий и элементов управления

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

Подключайте эмоции при редких и радостных событиях:

• Пользователь сдал всю отчетность,
• Завершил миграцию в ваш сервис,
• Не получил за год ни одного требования.

Полезно и правильно отмечать достижения пользователя, пытаться развлечь его в момент триумфа.

Набор капсом запрещен

Слова, набранные заглавными буквами, означают крик в речи, а мы не кричим на пользователей.

Старайтесь не использовать восклицательный знак

Здравствуйте

Здороваться обязательно в маркетинговых и новостных рассылках и запрещено в «технических» письмах.

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

Пожалуйста

Не просите пользователя сделать что-то через «пожалуйста». Лучше объясните пользу.

Извините

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

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

Когда пользователь загрузит некорректный XML-файл отчета или фотографию вместо xml-файла, мы покажем ошибку без «извините». В таких случаях нужно просто сообщить о проблеме.

Если сообщение укладывается в одно—два простых предложения, заголовок не нужен

Часто в таких случаях добавляют бесполезный заголовок, чтобы был: «Уважаемые пользователи», «Важное объявление», «Внимание!» или «Убедительная просьба!». Последние два — признак сообщения, до которого никому нет дела.

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

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

Чтобы дойти до сути этого сообщения, придется дочитать до конца:

Если нужно, чтобы пользователи подписались на уведомления, то заголовок может быть такой:

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

Если вы видите, что заголовок получается слишком частным, а тема гораздо шире, то обобщите: «Изменился порядок ответа на требование». Так тоже можно, но только не «Уважаемые пользователи» и не «Вниманию налогоплательщиков». Налоговые инспекторы так могут писать, а мы — нет.

В веб-сервисах обращение к аудитории в заголовке бессмысленно. Заголовок «Уважаемые …» уместен, когда объявление нацелено на одно подмножество людей из всех, кто его увидит. Так бывает редко. Например, вы вешаете в коридоре объявление для дизайнеров Контура и хотите, чтобы его читали только дизайнеры. Или вы ищете программиста в своей проект — тогда заголовок «Программисты, есть работа!» будет к месту.

Когда в веб-сервисе пишут «Уважаемые пользователи», а в подъезде «Уважаемые жильцы и гости» — заголовок не выполняет работу, потому что кроме них не к кому обращаться.

Если произошла ошибка, напишите, что произошло, с точки зрения пользователя, а не с точки зрения системы

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

Заголовки сообщений об ошибках должны различаться

Это удобно пользователю и консультанту. Консультант техподдержки сможет по одному заголовку определить проблему. А пользователь при повторных ошибках сможет с первого предложения понять, что произошло и что делать дальше, не дочитывая сообщения до конца. Когда «Произошла неизвестная ошибка» — трудно будет всем.

Чтобы пользователь предотвратил проблему в следующий раз, обучите его

Расскажите пользователю, что делать, чтобы ошибка не возникала в будущем. Делайте это в последнюю очередь. Сначала пишем «что произошло», потом «как исправить» и только потом «что делать, чтобы такое не происходило».

В правилах орфографии и пунктуации дизайнеры руководствуются

этим гайдом,

справочником Лопатина,

справочником Мильчина и Чельцовой.

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

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

Заголовок не может заканчиваться двоеточием

Даже если это заголовок списка и после него идет ряд однородных членов, двоеточие все равно не нужно.

Правильные кавычки — «кавычки-елочки» для первого уровня и „кавычки-лапки“ для второго уровня

В хинтах и тултипах точка ставится только между предложениями и не ставится, если предложение одно

Хинты и тултипы описывают назначение или работу элемента интерфейса. Они поясняют и подобны подписи к картинке. Поэтому к ним применяется правило подписи к картинке.

Буква «ё» используется только там, где возможно разночтение и из контекста не понятно, какое слово подразумевалось

все — всё

узнает — узнаёт

Малоизвестные имена собственные с буквой «ё»

Если из контекста не понятно, используется слово «все» или слово «всё», то букву «ё» необходимо оставить. Если разночтение невозможно или из контекста понятно, какое слово имелось в виду, используйте букву «е».

В веб-сервисах, на промосайтах, в почтовых рассылках и рекламных материалах «вы» пишется со строчной буквы

По правилам русского языка обращение на «вы» к единственному человеку — само по себе форма уважения. «Вы» с заглавной (большой) буквы уместно в личной и деловой переписке с человеком, которого вы очень уважаете. Например, вы мужчина и пишете даме сердца, или вы организатор конференции и приглашаете выступить мировое светило веб-разработки.

Веб-сервисы, промосайты, почтовые рассылки и рекламные материалы не относятся ни к личной, ни к деловой переписке. «Вы» в них — мерзкое заискивание, подобострастие и канцеляризм. Это — признаки фальши, а фальшь снижает доверие к тексту.

Мы уважаем наших пользователей и русский язык, поэтому пишем «вы». Если вам нужен ультраавторитетный источник, знайте, Д. Э. Розенталь на нашей стороне.

Слова «компания», «клиент» и остальные формы обращения пишутся со строчной, если это не первое слово в предложении

Вместо слов «функционал» и «функциональность» используйте менее сленговое слово «возможность». Еще лучше — сразу написать о том, что сервис научился делать

Название «Контур» и названия продуктов склоняются. Не склоняется только «СКБ Контур»

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

«СКБ Контур» не склоняется потому, что в названии компании присутствует аббревиатура. Зато можно просклонять родовое слово перед ним.

Пишите реалистичную «рыбу», с настоящими реквизитами: ИНН, КПП, названиями организаций

Для макетов в Фигме можно использовать плагин Fake Data Generator | RU. Он умеет генерировать адреса электронной почты, номера телефонов, ФИО, и номера, например ОГРН, а также вставлять настоящие названия организаций.

Вписывайте короткие, средние и длинные ФИО и адреса, а не те, которые с запасом влезают в поля

Пишите настоящие сообщения и ошибки из веб-сервиса, а не «Здесь текст ошибки»

Не пишите в прототипе «прикольные» и грубые имена и названия. Особенно в прототипе для тестирования

Не допускайте фактических и логических ошибок в прототипах

Бухгалтер разбирается в своей предметной области и сразу видит нестыковки. Фактические и логические ошибки в прототипе приводят к дискуссии с юзабилистом и мешают погружению в процесс.

Прототип с реквизитами настоящих организаций не должен выходить за пределы Контура. Для публикации в блогах и СМИ подготовьте скриншоты без реквизитов реальных организаций. Персональных данных людей это тоже касается

Используйте одни и те же слова для обозначения объектов и действий над ними

Если пользователь в одном окне прочитает «сертификат», в другом «КЭП», а в третьем — «ключ», у него не образуется связь между этими словами, он не поймет, что это одно и то же.

Чтобы избежать повтора в соседних предложениях, используйте разные способы указания

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

Как писать об оплате и продлении сервиса и о сертификате

Покупка и продление

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

Пакет можно заказать, купить и оплатить.

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

Окончание

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