Для редакторов, технических авторов и специалистов поддержки, которые превращают экспертные заметки в инструкции. Работаем с вымышленным описанием функции: отделяем факты от обещаний, составляем вопросы эксперту, перестраиваем текст по действиям читателя и проверяем альтернативный сценарий ошибки.
Содержание 5
Для кого
Для авторов справки, редакторов продукта и специалистов, которые объясняют пользователям сложные действия. Не нужны навыки программирования. На старте выдаётся учебная заметка о вымышленном планировщике; можно принести собственный обезличенный текст, если его разрешено использовать в групповом разборе.
До начала
- Выберите небольшой учебный сюжет, который можно разобрать целиком.
- Подготовьте исходники, на использование которых есть права.
- Проверьте доступ к выбранному инструменту; платная подписка не входит в авторскую стоимость.
- Сформулируйте один вопрос, на который хотите получить ответ в разборе.
Программа
- Разделить факт, мнение и рекламное обещание.
- Составить редакционное задание.
- Провести короткое уточняющее интервью.
- Собрать карту источников.
- Отредактировать структуру и язык.
- Пройти проверку по сценарию читателя.
Самостоятельная работа
Разметьте в черновике числа, обещания, условия и цитаты. Для спорных утверждений составьте вопросы владельцу функции, не подменяя ответы догадками. Затем напишите инструкцию из трёх частей: условия перед действием, последовательность шагов, ожидаемое состояние и путь при ошибке. Сохраните исходник для сравнения.
Как оценивается учебная работа
- ☐Каждое проверяемое утверждение имеет источник или явный статус «нужно уточнить».
- ☐Условия и ограничения стоят до действия, на которое влияют.
- ☐Шаги называют наблюдаемые действия и ожидаемые состояния.
- ☐Описан хотя бы один путь восстановления после ошибки.
- ☐Заголовок и анонс не обещают больше, чем объясняет инструкция.
Результат обучения
Одна отредактированная инструкция с условиями, шагами и восстановлением после ошибки; реестр утверждений со статусами проверки; список вопросов эксперту и редакторский чек-лист перед выпуском.
Работа с ИИ
Авторский сценарий. Генеративные инструменты помогают подготовить варианты; проверку смысла, качества, прав и окончательное решение выполняет человек.