Документ, который применяют без автора рядом
Эта лекция не о том, как писать. Она о документе, из-за которого другие пишут одинаково — и о механике, благодаря которой этот документ соблюдают, когда вас нет в переписке. Главная конструкция умещается в одну строку: правило, исполнение которого никто не проверяет, правилом не является. Всё остальное здесь — раскрытие этой строки.
Жанр известен своим главным провалом: документ пишут месяцами, торжественно выкладывают и потом не открывают. Поэтому лекция устроена не как оглавление идеальной редполитики, а как ответ на четыре вопроса: из чего документ собирается, как в нём записывают правило, где он лежит, чтобы его нашли за десять секунд, и кто отвечает за его изменение.
Не полный, не красивый и не согласованный. Тот, которым пользуются. Полнота — не цель жанра: чем длиннее документ, тем меньше шансов, что его дочитают. Из этого следует всё остальное, включая порядок работ, при котором редполитику пишут не первой, а последней.
Лекцию ждут две профессии сразу, и примеры чередуются между их рабочими столами. Коммерческий редактор — редакция живых авторов, внешние подрядчики, приёмка текстов, спор с заказчиком о вкусах. UX-писатель — глоссарий продукта, правила на уровне компонента, дизайн-система, ревью каждого экрана, которое хочется снять. Механика документа одна, носитель разный: у первого это редакция, у второго — дизайн-система.
- Порядок сборки: сначала гайды, потом редполитика
- Критерий заведения правила — третий спор, а не первый
- Запрет из трёх частей: слово, замена, законный контекст
- Карточка термина и правило «одна запись — одно понятие»
- Документ как основание тестового задания и как защита от вкусовых правок
- Глобальный слой плюс дельты вместо разделов по каналам
- Правила на уровне компонента и образцовый разбор дат и времени
- Пары «да/нет» с пометкой ошибки и порядком «сначала да»
- Стандарты внутри дизайн-системы, а не в отдельном вики
- Автопроверка и три уровня строгости для тысячи старых экранов
Граница с соседями в каталоге проведена жёстко. Как звучать — это лекция про tone of voice: там голос против тона, измерения тона, голосовая карта, матрица ситуаций, спорные случаи языка. Здесь голос и тон — один из разделов редполитики, и разговор идёт не о том, как звучать, а о том, как этот раздел записать, чтобы им пользовались. Чистка текста и проверяемое правило разобраны в лекции про информационный стиль — понятие проверяемости берётся здесь как данность и применяется к самому документу. Календарь выпуска — лекция про контент-план. Права, маркировка и договоры — лекция про право для контента; редполитика на эти темы только ссылается.
Уровень — продвинутый. Предполагается, что вы уже пишете и редактируете. Лекция не учит писать; она учит проектировать документ и механику его соблюдения.
Здесь не будет ни одного процента экономии от глоссария и единой терминологии: те цифры, что ходят по рынку, приходят из блогов вендоров систем перевода, без методологии и выборки. Не будет и знаменитого «сотрудник тратит 2,5 часа в день на поиск информации» — эта цифра не выдерживает проверки происхождением. Вместо чужих процентов — механизм и список показателей, которые меряются у себя.
И главное: редполитика не отменяет ревью. Она снимает споры о вкусах и сокращает круги правок. Проверка смысла, фактов и уместности остаётся за человеком — в редакции и в продукте одинаково.
Три документа под одним именем: гайд, глоссарий, редполитика
Разговор о правилах письма почти всегда начинается с путаницы в названии. «Нам нужен гайд», «давайте заведём глоссарий», «пора писать редполитику» — три разные задачи, три разных объёма работ и три разных срока, но в переписке они звучат как синонимы. Различение, которое дальше используется во всей лекции, взято из разбора собственной работы UX-редактора Купера (до ребрендинга — СберМаркет) и совпадает с тем, как устроены описания публичных дизайн-систем.
| Документ | Охват | Заводится | Пример |
|---|---|---|---|
| Гайд | одна тема | под конкретную текущую боль | тексты в интерфейсе; типографика; общение с пользователями |
| Глоссарий | одна тема или домен | когда одну сущность зовут по-разному | термины ретейлеров; юридические термины; стоп-слова; свой глоссарий на каждый домен продукта |
| Редполитика | вся компания | когда гайдов накопилось и они противоречат друг другу | общий документ «от тона до запятых» |
Гайд — инструкция по одной теме. Его заводят не «чтобы был», а потому что болит прямо сейчас: тексты в интерфейсе разъезжаются, типографика в статьях у каждого своя, поддержка отвечает пользователям в трёх разных регистрах. У автора разбора таких гайдов три, и каждый вырос из своей боли.
Глоссарий — сборник понятий внутри темы или домена. Названные им задачи вполне приземлённые: склонение имён собственных, консистентность и снижение юридических рисков. Обратите внимание на третью: словарь — это не только про красоту, это ещё и про то, чтобы слово, у которого есть правовое значение, не появилось там, где компания за него отвечает.
Редполитика — общекорпоративный документ, охватывающий всё, «от тона до запятых». Два эффекта, которые называют оба независимых источника: она ускоряет ввод новичка в работу и снижает число правок.
Гайд — «как оформляем подписи к иллюстрациям». Глоссарий — как пишем названия клиентских продуктов и как их склонять. Редполитика — общий документ, который получает новый подрядчик вместе с первым заказом.
Гайд — «тексты в интерфейсе». Глоссарий — термины домена: как называется сущность в биллинге и как её же зовут в личном кабинете. Редполитика — слой, общий для интерфейса, писем, поддержки и маркетинга.
Различение нужно не ради терминологической чистоты. Оно отвечает на вопрос, с чего начинать, — и ответ противоположен интуиции.
Дальше нужен аккаунт
Прогресс и монеты сохранятся.