Распространение учебной серии
Календарь определил, когда материал может стать локально готовым. Теперь нужно спроектировать путь читателя к учебной серии. Анонс отдельного урока полезен, когда объясняет не только новизну страницы, но и её место: что требуется знать, какой результат получится и куда перейти дальше. В этом уроке соберём пакет распространения для условной серии SER-01 о переносе старого сайта.
SER-01 — редакционная модель, а не новая опубликованная программа. Она содержит три карточки: постоянный адрес, общий шаблон и проверка доступности. Используем идентификаторы, чтобы не придумывать действующие URL отсутствующих страниц. lesson-07 архива хранит макет оглавления и два анонса, сообщения никуда не отправляются.
Урок и вход в серию
Посетитель может начать с первой страницы, случайного результата поиска или сообщения о третьем уроке. Поэтому анонс должен учитывать два пути: человек уже проходит серию или видит её впервые. Для продолжающего читателя важно новое действие. Для новичка — минимальные предпосылки и точка входа. Один длинный перечень всех уроков не всегда помогает обоим, особенно если в сообщении потеряно главное объяснение.
В SER-01 первый урок PUB-01 отделяет исходник от URL, второй PUB-02 посвящён общей оболочке, третий PUB-03 — ожидаемому ответу по прежнему пути. Порядок отражает зависимость. Проверка адреса понятнее, когда читатель уже знает, что именно сборка должна сохранить. Мы не утверждаем, что эти три карточки заменяют всю программу обновления сайта.
| Карточка | Что уже известно | Новый результат | Вход новичка |
|---|---|---|---|
| PUB-01 | Назначение ссылки | Постоянный путь | Начать здесь |
| PUB-02 | Путь отделён от исходника | Общая оболочка | Вернуться к PUB-01 |
| PUB-03 | Страница собрана по пути | Признак доступности | Сверить предпосылки |
Макет оглавления содержит не просто номера, а результаты. Читатель может понять, зачем идти дальше, не открывая каждую страницу. В карточке третьего урока отдельно укажем, что учебные сценарии не исполнялись. Формулировка «мы проверили все адреса» была бы неверна для этой лаборатории и меняла бы статус примера.
Самостоятельный анонс
Для PUB-01 подготовим короткий текст: «Имя Markdown-файла и адрес страницы решают разные задачи. Если вы переносите старый урок, сначала сохраните его прежний путь в реестре. Затем свяжите с ним новый исходник. В первой главе разбираем эту связь на .php-адресе». Даже без перехода человек получает полезную мысль. Ссылка ведёт к подробному объяснению, а не скрывает всё содержание за обещанием.
Для PUB-03 анонс изменится: «Строка в реестре ещё не доказывает доступность страницы. В следующей главе отличаем назначенный путь от ожидаемой выдачи материала. Перед чтением нужно понимать, как путь связан с исходником». Здесь есть место в серии и предпосылка. Не нужно повторять весь первый анонс, иначе продолжение кажется другой упаковкой той же мысли.
У пакета распространения три объекта: основная статья, оглавление и адаптированное сообщение. Их содержание связано, но каждое решает своё действие. Статья объясняет механизм, оглавление помогает выбрать шаг, сообщение привлекает внимание конкретной полезной мыслью. Если все три объекта содержат одинаковое длинное вступление, редакция теряет преимущества разных форматов.
В рабочем проекте ссылки пакета должны вести на существующие страницы. Для учебных карточек PUB-02 и PUB-03 в приложении стоят отсутствующие адреса null, а не вымышленные маршруты ProfessorWeb. Перед реальным выпуском редактор должен сопоставить их с опубликованными материалами. Так документ остаётся пригодным для подготовки и не становится источником сломанных внешних ссылок.
Продолжение и состояние страницы
Если урок пока черновик, пакет получает статус ready_local_only. Это означает, что текст анонса можно редактировать, но внешнее распространение не разрешено и не выполнено. Даже ссылка на локальную страницу не подходит для читателя внешнего канала. Нужно отличать адрес предпросмотра для редактора от публичного адреса для аудитории. В этой серии мы не заменяем один другим автоматически.
Предположим, PUB-02 задержался, а PUB-03 уже подготовлен. Есть два разумных варианта: отложить анонс третьего урока или сделать его самостоятельным с достаточным объяснением предпосылки. Нельзя оставить в сообщении ссылку на недоступное продолжение и считать, что оно появится позже. План пакета должен отражать реальное состояние зависимостей, иначе новый читатель попадает в незавершённый маршрут.
Для старых материалов укажем аккуратный вход: страница каталога прежних уроков остаётся способом найти библиотеку. Новая серия не должна объявлять старый корпус бесполезным только ради собственного продвижения. Если старый урок объясняет другое понятие, ссылка к нему может быть дополнительной. Она не должна подменять основной следующий шаг и заставлять новичка выбирать между десятками направлений без пояснения.
Проверка пакета проводится с двух ролей из первого урока. Анна должна понять, что её прежние адреса участвуют в примере. Илья должен увидеть различие исходника и публичного пути. Если анонс говорит только «мы обновили сайт», полезный результат скрыт. Если оглавление содержит все технические детали сразу, оно перестаёт помогать выбору первого шага.
В after.json добавлены три карточки серии и состояния ссылок. Ожидаемый результат — согласованный маршрут чтения без придуманных опубликованных страниц. artifact.md содержит готовые учебные формулировки анонсов. Они пригодны для редакционного обсуждения, но не являются сообщениями действующего канала. Число просмотревших или перешедших не заполнено, потому что распространения не было.
Добавим к пакету карту проверки ссылок. Для каждого перехода есть источник, назначение и требуемое состояние назначения. Из анонса PUB-01 читатель должен попасть в полный урок; из урока — в оглавление; из оглавления — выбрать следующий доступный шаг. В локальном документе эти отношения записаны через идентификаторы, поэтому их можно проверить без открывания выдуманного адреса. При подготовке реального выпуска редактор подставит подтверждённые URL и сохранит соответствие. Если одна карточка снята с выпуска, изменятся все входящие ссылки пакета. Это конкретное преимущество общего реестра: он показывает последствия решения для маршрута чтения. Само наличие карты не доказывает доступность страницы по сети; оно задаёт предмет будущей проверки и не смешивает редакторскую готовность с внешней публикацией.
Попробуйте изменить аудиторию на читателя, который уже прошёл PUB-01. В сообщении о PUB-02 можно сократить объяснение адреса, но нельзя убрать новое действие с общей оболочкой. Так распространение поддерживает последовательность курса, сохраняя самостоятельную пользу каждого материала. Следующий урок оформит эти решения в структуру учебного Telegram-канала.