Аудитория и задача публикации

Статья может быть написана аккуратно и всё же не помочь читателю. Так происходит, когда редакция знает название технологии, но не знает, какую задачу человек решает с её помощью. Начнём учебную редакцию ProfessorWeb с описания такой задачи. Результатом урока станет карточка аудитории, по которой можно выбрать содержание, пример и место публикации.

Все роли, ответы и числа этой серии придуманы для обучения. Мы используем ProfessorWeb как знакомый проект с библиотекой уроков, а не приписываем его посетителям проведённые опросы. Локальные состояния и редакторские образцы находятся в архиве серии, папка lesson-01. Никаких публикаций во внешних аккаунтах здесь нет.

Задача вместо общего портрета

Фраза «наша аудитория — программисты» слишком широка для задания автору. Начинающий разработчик пытается понять, почему его ссылка ведёт на отсутствующую страницу. Владелец старого сайта боится потерять прежние адреса после смены генератора. Автор учебных материалов хочет добавлять статьи через Markdown. Эти люди могут читать один сайт, но ожидают разных объяснений. Возраст и название должности сами по себе не определяют нужный пример.

Введём две учебные роли. Анна поддерживает небольшой сайт с накопленными материалами и умеет редактировать HTML. Илья пишет новые уроки, понимает Markdown, но не отвечает за сервер. Это рабочие персонажи, а не реальные сотрудники. Для каждого укажем ситуацию, затруднение и действие, которое станет возможным после чтения. Не будем дополнять карточку неподтверждёнными доходами, интересами или психологическими характеристиками.

Роль	Ситуация	Нужный результат	Неизвестное
Анна	Замена старого движка	Сохранить список прежних URL	Число страниц её сайта
Илья	Добавление новой серии	Назначить статье постоянный адрес	Знание сборщика

Таблица показывает границы объяснения. Анне нужен пример сохранения .php-адреса, Илье — связь Markdown-файла и permalink. Их можно соединить в одном вводном материале, если общий результат сформулирован как «отделить адрес страницы от имени исходного файла». Полный курс администрирования сервера в эту задачу не входит.

Обещание материала

Возьмём редакторскую карточку PUB-01: «Как сохранить адрес урока при переносе в Markdown». Её обещание состоит из трёх частей: читатель выписывает существующий адрес, записывает его в метаданные и понимает, что название файла можно менять независимо. Ожидаемый результат — одна строка реестра адресов и один пример метаданных. В карточке также записываем предпосылку: человек понимает, что такое ссылка, но может не знать термин canonical.

Теперь сравним два вступления. В первом автор сообщает, что Markdown удобен, современен и ускоряет работу. Во втором он показывает прежний адрес /my/LINQ/linq_xml/level7/7_1.php и объясняет, почему ссылка должна продолжать открываться после переноса. Второй вариант связан с задачей Анны. Его полезность можно оценить по пониманию операции, не дожидаясь статистики переходов и обещаний роста трафика.

Редакторская цель тоже должна быть предметной. Для PUB-01 это помочь посетителю перейти от одного материала к серии о статическом сайте. Цель не даёт права превращать каждый абзац в рекламу курса. Сначала читатель получает самостоятельное объяснение, затем видит продолжение. Мы различаем полезный результат для человека и действие, нужное проекту: они могут поддерживать друг друга, но не являются одним показателем.

В after.json урока появляется решение content-smm-01-audience. Оно хранит две роли, выбранную публикацию и её результат. Поле fictional остаётся истинным, external_actions — ложным. Изменение файла означает, что редакционная гипотеза описана. Оно не означает, что аудитория действительно испытывает указанные трудности или что материал уже размещён.

Как уточнять гипотезу

Предположим, в следующем учебном сценарии выяснилось: Илья умеет задавать permalink, но не понимает, откуда брать старые адреса. Тогда изменяется не вся аудитория проекта, а одна предпосылка карточки. Материал должен включить источник реестра: сохранённый список страниц, внутренние ссылки или выгрузку прежнего сайта. Мы не называем гипотезу доказанной только потому, что она звучит правдоподобно.

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

Сохраняйте вместе с наблюдением его происхождение. В учебной карточке это пометка «сценарий автора». Для реального замечания понадобились бы дата, ссылка на материал и обезличенный пересказ проблемы. Имя, почта и полный текст личной переписки не нужны для выбора примера. Такое ограничение данных принято в нашей редакционной модели; оно не заменяет отдельного разбора правовых условий проекта.

Проверка карточки проводится чтением, а не оценкой её длины. Если по ней нельзя решить, включать ли объяснение HTTP-ответа, границы темы не определены. Если результат выражен словами «узнать всё о миграции», автор не сможет выбрать достаточный пример. Для PUB-01 ответ ясен: связь адреса и исходника входит в тему, настройка DNS и перенос почты остаются за её пределами.

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

Ещё один способ проверить обещание — попросить другого редактора выбрать пример только по карточке. Если он показывает создание нового домена, а вы ожидали сохранение старого пути, описание задачи допускает слишком широкое толкование. Добавьте исходное условие: сайт уже существует, его ссылки известны, меняется способ хранения содержания. При этом не задавайте автору каждое предложение. Карточка ограничивает результат, но оставляет место для ясного объяснения и подходящего контрпримера. В нашем образце достаточно исправить формулировку ситуации, а роли Анны и Ильи сохраняются. Различайте также ожидание и обещание: ожидание читателя можно исследовать, обещание статьи редакция принимает на себя. Если пока не известно, можно ли обслуживать прежний путь в выбранном окружении, статья должна объяснить условие, а не гарантировать результат до проверки.