Технический писатель: чем занимается специалист, какие навыки нужны и как учиться

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

Что входит в работу

Перед выпуском версии писатель собирает изменения из задач в трекере и превращает их в понятные примечания к выпуску. Он же дописывает разделы руководства о новых экранах, обновляет скриншоты, правит статьи базы знаний по обращениям в поддержку. Если у продукта есть API, писатель описывает методы и коды ответов с примерами запросов.

В проектах для госзаказчиков добавляется комплект документов по стандартам: описание программы, руководства оператора и администратора, программа и методика испытаний. Ошибка в инструкции по резервному копированию или в описании прав доступа обходится дорого, потому что документу верят.

Учебный пример: одна функция, два читателя

Условная ситуация. Компания поставляет региональному ведомству систему приёма обращений граждан. В новой версии обращения сами распределяются по исполнителям, а внешние системы могут узнать статус обращения через API.

Писатель начинает со стенда: создаёт тестовое обращение, смотрит, как оно попадает к исполнителю, и выясняет у разработчика, что будет, если подходящего исполнителя нет. Затем дополняет руководство пользователя. Для автоматизированных систем его состав задаёт ГОСТ Р 59795-2021, действующий с 30 апреля 2022 года: введение, назначение и условия применения, подготовка к работе, описание операций, аварийные ситуации, рекомендации по освоению. Новая функция попадает в «Описание операций», случай без исполнителя — в «Аварийные ситуации», с текстом сообщения, которое увидит сотрудник.

Для интеграторов тот же механизм описывается иначе: метод получения статуса, обязательные параметры, перечень статусов, ответ на ошибочный запрос и пример, который писатель сам выполнил на стенде. Перед сдачей тестировщик проверяет оба раздела по шагам.

Чем отличается от соседних профессий

Копирайтер убеждает купить или записаться, а инструкция никого не уговаривает: она должна привести читателя к результату с первого раза. Писательское мастерство в смысле прозы здесь почти не пригодится: термин нельзя заменить синонимом ради разнообразия, а повтор допустим, если снимает двусмысленность.

Ближе всего к техписателю системный аналитик. Он описывает, что нужно сделать, до начала разработки: требования, сценарии, техническое задание по ГОСТ 34. Писатель описывает то, что уже сделано, и для конечного читателя, хотя в небольших командах роли совмещают. Подход docs as code, когда документация хранится в репозитории и проходит ревью вместе с кодом, разобран в нашей статье о Git.

Профстандарт: где проходит граница между уровнями

Профессию описывает стандарт «Технический писатель (специалист по технической документации в области информационных технологий)», утверждённый приказом Минтруда № 609н от 3 октября 2022 года. Он действует с 1 марта 2023 года до 1 марта 2029 года и заменил прежний стандарт 2014 года, утверждённый приказом № 612н.

Интереснее всего в нём граница между пользовательской документацией и документацией для разработчиков. Обобщённая функция B «Разработка документации, ориентированной на конечного пользователя» требует бакалавриата и не требует опыта. Функция D «Описание продуктов с точки зрения инженера или разработчика», куда входит трудовая функция D/04.6 о документации на программные интерфейсы и средства разработки приложений, требует не менее года опыта в разработке IT-продукции «в качестве конструктора или программиста». Среди умений для неё названо «составлять и отлаживать несложные программы и тестовые примеры».

Выходит, описание API стандарт относит не к редакторской, а к инженерной работе. Обязательным это требование не является: по статье 195.3 Трудового кодекса профстандарт обязателен, только если квалификацию для должности устанавливает закон или иной нормативный акт, а для техписателя таких норм нет. Работодатель может взять на описание API человека без программистского стажа, но на собеседовании проверит, умеете ли вы читать код и сами выполнять запросы.

Какие знания и инструменты понадобятся

Основа — умение структурировать: разбить задачу пользователя на шаги, отделить обязательное от справочного. Нужны грамотный русский и английский на уровне чтения документации. Из инструментов — текстовый процессор со стилями, Markdown или AsciiDoc, Git, генераторы сайтов документации, вики вроде Confluence. Для API пригодятся основы HTTP, JSON и спецификация OpenAPI.

Стандарты стоит знать хотя бы по составу документов. По опросу documentat.io, проведённому в январе 2024 года среди 365 русскоязычных техписателей, по ГОСТ пишут 44 % участников, и 81 % из них работает с серией ГОСТ 19 — Единой системой программной документации.

Что может оказаться трудным

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

С чего начать и в каком порядке осваивать

Шаги ниже идут так, чтобы каждый давал работу в портфолио и опирался на предыдущий: сначала инструкция, проверенная на живом читателе, затем инструменты команд разработки и только потом API и стандарты, где без первых двух навыков легко утонуть.

1. Напишите инструкцию к одной задаче в знакомой программе с открытым кодом. Дайте её человеку, который программу не видел, и молча понаблюдайте, где он ошибётся.
2. Перепишите инструкцию в Markdown и опубликуйте её из репозитория как маленький сайт документации.
3. Возьмите бесплатный публичный API, выполните несколько запросов и опишите два-три метода: параметры, ответы, ошибки, пример.
4. Переложите первую инструкцию в структуру руководства пользователя по ГОСТ Р 59795-2021.
5. Предложите правку документации открытого проекта: принятое сопровождающими исправление — сильный аргумент на собеседовании.

Если нужен курс с дипломом о переподготовке, посмотрите программу «Технический писатель» от АПОК: 256 часов дистанционно без расписания, итоговая работа на 40 часов, принимают с высшим или средним профессиональным образованием. Учтите распределение часов: самой профессии посвящён модуль на 28 часов, остальное — Windows, Word, PowerPoint и компьютерная графика. Git, Markdown и описание API придётся добирать самостоятельно.

Как выбрать обучение

Перед оплатой любого онлайн-курса спросите школу, какие документы вы напишете сами и кто их проверит. Хороший признак — задания на учебном продукте с обратной связью от практикующего писателя, слабый — только тесты по теории.

Отдельного рейтинга школ по технической документации на сайте нет, поэтому ближайший ориентир — рейтинг онлайн-школ по системной аналитике. Это смежное направление, а не подборка для техписателей, но по нему удобно сравнить школы, где учат работать с требованиями и интеграциями.

Для документации разработчика профстандарт подсказывает следующий шаг: научиться читать код и писать небольшие проверочные программы. Без этого описание API остаётся пересказом слов программиста.

Тем, кто хочет писать документацию к API, полезно понять, как интерфейсы проектируют. На онлайн-курсе «Системный аналитик с нуля» от Karpov.Courses за три месяца разбирают REST API, Swagger, Postman, UML и постановку задач разработчикам, а в портфолио остаются спецификации API и итоговый проект. Курс готовит аналитика, а не писателя, но именно эти навыки проверяют у кандидатов на описание API.

Как найти первую работу

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

Со временем можно перейти и в системную аналитику. Программу «Профессия Системный аналитик» от Skillfactory в обзоре называют подходящей в том числе для техписателей, тестировщиков и специалистов поддержки: центральный модуль на 100 часов посвящён подготовке технических заданий, есть Jira, Confluence, REST API, Swagger и Postman. Сроки обучения и число часов в описании расходятся, поэтому уточните их у школы до оплаты.

Сколько зарабатывает технический писатель

Свежих данных о зарплатах немного. Калькулятор зарплат Хабр Карьеры в начале октября 2026 года показывает для технического писателя 138 000 ₽ в месяц по 145 анкетам пользователей; период расчёта и разбивка по городам и грейдам на открытой странице не указаны.

Подробнее раскладывает зарплаты опрос documentat.io (декабрь 2023 — январь 2024 года, 333 участника из России, суммы на руки, без фрилансеров). Медиана по стране — 120 000 ₽, в Московском регионе — 140 000 ₽, в Санкт-Петербургском — 119 000 ₽, в других городах — 100 000 ₽. Во второй части опроса медиана у тех, кто пишет документацию к API, — 130 000 ₽, у описывающих архитектуру ПО — 160 000 ₽. Данным почти три года, поэтому сравнивайте по ним специализации, а не сегодняшние суммы.

Предложения работодателей смотрите в вакансиях с фильтром по региону и опыту, уточняя, указана сумма до вычета налога или на руки. Например, на Хабр Карьере в конце сентября 2026 года вакансия техписателя уровня middle с возможностью удалённой работы предлагала 120 000–130 000 ₽ — но это одна вакансия, а не статистика.

Проверить, подходит ли вам профессия, можно за выходные: напишите инструкцию к знакомой программе и отдайте её первому читателю. Если вам интересно, где он споткнулся, и хочется переписать этот шаг, профессия, скорее всего, ваша.