Что такое «Документация по задачам»
Пользователь открывает справку не ради знакомства с программой, а потому что застрял: нужно добавить сотрудника, сменить телефон в шапке, выгрузить заказы. Справочник, построенный по экранам и функциям, заставляет самому собирать ответ из нескольких разделов. Документация по задачам переворачивает порядок: заголовок — действие пользователя, текст — шаги, в конце — ожидаемый результат.
Идея давно закреплена в технической документации. В стандарте DITA выделяют три типа тем: задача, понятие и справка. В популярной схеме Diátaxis — четыре вида текстов: обучающие уроки, инструкции по задачам, справочник и объяснения. Смешивать их на одной странице не советуют.
Пример страницы-задачи
Как добавить нового автора в блог
- Что нужно заранее: права администратора и адрес почты сотрудника.
- Откройте раздел «Пользователи» и перейдите к добавлению нового пользователя.
- Заполните имя пользователя и почту, в поле «Роль» выберите «Автор».
- Оставьте отмеченным флажок уведомления и сохраните — сотруднику придёт письмо со ссылкой для установки пароля.
- Если письмо не пришло: проверьте папку «Спам» и настройки отправки почты сайта.
Одна задача — одна страница, глаголы в повелительном наклонении, названия кнопок — точно как в интерфейсе.
Как это устроено у WordPress
Документация проекта разделена по аудиториям. Руководства для владельцев сайтов на wordpress.org и учебные материалы Learn WordPress в основном построены вокруг задач: «как создать меню», «как обновить плагин». Для разработчиков есть справочник функций, классов и хуков — это справочная документация, и в ней задачи не описываются. Раньше и то и другое жило в Кодексе WordPress, где виды текстов смешивались. Общие принципы подготовки справки описаны в статье о документации.
Где это пригодится на практике
Сдавая сайт, я пишу владельцу короткие инструкции именно в таком формате: «как добавить новость», «как поменять цену», «как выгрузить заявки». Пять страниц по шагам со скриншотами полезнее длинного описания админки. Слабое место подхода — нехватка контекста: если пользователю непонятно, зачем вообще нужна рубрика, инструкция «как создать рубрику» не поможет. Поэтому рядом с задачами держат короткие объяснения понятий.
Связанные термины
Обновлено: 10 октября 2026

