Лекция «Редполитика и гайдлайн — документ, по которому пишут без вас»

Около 85 минут на 21 тема. Прогресс сохраняется, поэтому лекцию можно проходить частями и возвращаться к ней позже.

Начало — да: первые 1 тема открыты сразу, без регистрации. После бесплатной регистрации откроются темы до 2-й — вместе с частью из 63 тестов и монетами за верные ответы. Полная лекция — 99 ₽ навсегда, либо подписка на все лекции платформы от 499 ₽ в месяц.

Двадцать одна тема закрывает путь от различения трёх документов до одиннадцати красных линий. Сначала рамка: гайд — одна тема, глоссарий — понятия домена, редполитика — общекорпоративный документ «от тона до запятых», и собирается она из гайдов, а не пишется первой; каркас оглавления от NN/g из двух групп стандартов, где требования к стилю и тону занимают один пункт из пяти; глобальный слой плюс короткие дельты вместо разделов по каналам, из-за которых документ противоречит сам себе. Вторая часть — содержимое: три правила ведения терминологии из ISO 704 (одна статья — одно понятие, синонимы внутри статьи, омонимы по разным) и карточка термина с датой решения; организационная причина рассинхрона, из-за которой одну величину зовут «баланс», «доступные средства» и «текущая сумма»; правила на уровне компонента у Atlassian и их перенос на жанровые элементы редакции; образцовый разбор дат и времени, где у правила есть запрет, причина, исключение с форматом ISO 8601, названный ответственный и приём проверки; условия применимости пар «да/нет» из исследований обучения на примерах с ошибками — порядок «сначала да», обязательная пометка ошибки, зависимость от уровня подготовки; запрет из трёх частей на образце списка GOV.UK. Третья часть — механика соблюдения: почему документ не читают и как проектировать под человека, который ищет по ключевому слову и уходит через несколько секунд, вместе с разбором оспоренной цифры про 2,5 часа в день и заменяющих её измерений по разработчикам (20–30%, около 20%, 35–50%); линтер прозы, его границы и путь внедрения; три уровня строгости GitLab с рекомендацией вводить строгое правило мягким уровнем на тысяче старых страниц; порог третьего спора и проверяемость как критерий приёмки формулировки. Четвёртая — жизнь документа: чужой гайд как оглавление, а не ответ, с публичными образцами и иерархией приоритетов Google; владелец, версии, лог решений и исключение с датой истечения; пять шагов внедрения и правило «документ идёт к читателю»; ввод в работу, тестовое задание и защита автора формулой «покажите правило». Пятая — пределы: редполитика как контекст для модели с четырьмя названными ограничениями, метрики с двумя прикладными показателями и одиннадцать красных линий.

Разделением предмета. Лекция про tone of voice отвечает на вопрос «как мы звучим»: голос против тона, измерения тона, голосовая карта, матрица ситуаций, спорные случаи языка, аудит каналов. Здесь голос и тон — один раздел документа из десяти, и разговор идёт не о том, как звучать, а о том, как устроен документ, из-за которого мы звучим так все и всегда, включая нового подрядчика на третий день. Отсюда и содержание: устройство карточки термина, уровень формулировки правила, порядок ввода строгого правила на старом материале, лог решений, путь исключения и метрики соблюдения.

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

Юридически иногда можно: Mailchimp открыл свой документ под Creative Commons, исходники лежат на GitHub. Практически — нет. Правила выросли из продукта и аудитории конкретной компании, и перенос без пересборки даёт документ, который противоречит вашей собственной работе; практик описывает это сравнением с рисованием совы по глобусу. Чужой документ берут как оглавление и как источник вопросов, а ответы пишут свои. Отдельно полезна модель Google: свой гайд не обязан покрывать всё, он обязан назвать, куда идти за остальным.