Должностная инструкция: Технический писатель — обязанности и зарплата

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

Источник изображения: Pexels.

Кто такой технический писатель и чем он отличается от копирайтера

Технический писатель отвечает не за «интересность» текста, а за его проверяемость: каждое утверждение в инструкции должно соответствовать текущей версии продукта, а каждая команда в примере кода — выполняться без ошибки. Копирайтер продаёт, техпис документирует; первый может позволить себе метафору, второй — нет, потому что за метафорой в CLI приходит ошибка command not found.

Технический писатель, копирайтер и UX-писатель: в чём разница

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

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

Кому подходит профессия и какие качества важны

Профессия подходит людям, у которых есть терпимость к рутине сверки и способность задавать «глупые» вопросы инженеру, не боясь выглядеть некомпетентным. Техпис — это переводчик, а не генератор текста: он должен уметь читать чужой код на уровне понимания логики, но не обязан писать production-код.

• Внимание к деталям. Заметить, что в примере ответа API поле status приходит строкой, а в тексте описано числом, — базовая гигиена.
• Системность. Один и тот же термин в руководстве пользователя и в интерфейсе должен звучать одинаково, иначе поддержка получает вопросы «а что такое „учётная запись“ и чем она отличается от „профиля“».
• Готовность к переделке. Продукт меняется между спринтами, и документ, сданный в понедельник, к пятнице может устареть на 30%.

Должностные обязанности технического писателя по участкам работы

Обязанности техписа в вакансии редко описывают полностью: в реальности к «написанию документации» добавляется участие в релизном цикле, разбор тикетов от поддержки и поддержание терминологии в интерфейсе. Ниже — три участка, которые встречаются почти в каждой должностной инструкции, с указанием того, за что специалист отвечает лично.

Вывод: техпис отвечает не за «текст», а за то, чтобы документ не разошёлся с продуктом.

Пользовательская документация и база знаний

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

В базу знаний часто приходят задачи из поддержки: «пользователи не понимают, почему не проходит оплата». Техпис не переписывает ответ поддержки, а идёт в продукт, воспроизводит сценарий и пишет статью с точной формулировкой ошибки и путями решения. Хорошая статья в базе снижает поток тикетов на 10–15% по конкретной теме — это измеримый результат, который идёт в годовую оценку. Смежная компетенция — повышение квалификации по делопроизводству и документообороту: она помогает выстроить порядок в регламентах и внутренних инструкциях.

API-документация и релиз-ноты для разработчиков

API-документация — самый технически плотный участок: здесь техпис работает со спецификацией OpenAPI, проверяет коды ответов (200, 400, 401, 403, 429, 500), описывает параметры пагинации и лимиты запросов. Ошибка в описании метода стоит интегратору нескольких часов отладки, а компании — репутации: разработчик, дважды наткнувшийся на неверный пример, перестаёт доверять справочнику и идёт читать исходники.

Релиз-ноты для разработчиков — отдельный жанр. Это не маркетинговый анонс, а перечень изменений с указанием breaking changes. Если версия API перестала принимать старый параметр limit, а в changelog этого нет, чужой сервис падает в проде. Поэтому техпис обязан вычитывать дифф изменений и сверять его с задачей в трекере, а не просто пересказывать тикет.

Внутренние регламенты, стандарты и обучение сотрудников

Внутренние документы — то, что техпис делает для своих же коллег: инструкции для первой линии поддержки, регламенты эскалации, гайды по развёртыванию для DevOps. Здесь особенно важна единая терминология: если в одном регламенте написано «кластер», в другом «среда», а в интерфейсе — «пространство», новый сотрудник теряется на третьем документе. Близкая тема — разряды секретарей и их должностные обязанности: она показывает, как в реальной практике устроена работа с документами и их согласованием.

Обучение сотрудников часто ложится на техписа потому, что он единственный, кто прочитал весь продукт вдоль и поперёк. Онбординг-гайд с чек-листом на первые 5 дней и ссылками на конкретные разделы документации экономит наставнику 3–4 часа в первую неделю новичка.

Что должен знать и уметь технический писатель

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

Профессиональные навыки и инструменты

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

• Markdown и AsciiDoc. Большинство docs-as-code проектов собираются из исходников в Git, и правка в вики без ревью там не проходит.
• Git. Ветки, пул-реквесты, конфликты — техпис работает в том же репозитории, что и разработчики, только с папкой docs/.
• Swagger / OpenAPI. Читать спецификацию и замечать расхождения между ней и фактическим ответом сервера.
• CI для документации. Сборка статического сайта (MkDocs, Sphinx, Docusaurus) запускается автоматически, и сломанная ссылка роняет билд.

Для промышленной разработки добавляется знание стандартов ЕСПД и требований к программной документации: там документация сдаётся в виде конкретных документов — «Руководство пользователя», «Описание программы», «Пояснительная записка», — и оформление регламентировано до шрифта и рамки.

Личные качества и soft skills

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

• Настойчивость без конфликтности. Разработчик может отмахнуться от вопроса, но техпис, который не получил ответ, сдаст документ с дырой.
• Умение работать с отказами. «Это не документируется» — частая реакция, и нужно уметь обосновать, почему интегратору без этого нельзя.
• Планирование. Оценка задачи в часах на написание и ещё столько же на ревью и правки — норма, а не завышение.

• ●Git и работа с ветками
• ●OpenAPI и чтение спецификаций
• ●Markdown или AsciiDoc
• ●Понимание HTTP-кодов и заголовков
• ●Навык задавать точные вопросы инженеру

Как стать техническим писателем: обучение и вход в профессию

В технического писателя не берут «просто с улицы» в крупный продукт, но войти можно за 3–6 месяцев целенаправленной подготовки, если есть технический бэкграунд или опыт работы с текстами в смежной области. Ключевое на входе — не диплом, а портфолио из проверяемых документов: инструкция, которую можно выполнить, и справочник, который совпадает с реальным API.

Какое образование нужно и нужен ли диплом

Формально профстандарт «Технический писатель» (утверждён приказом Минтруда № 609н, действует с 1 марта 2023 года) относит должность к уровням квалификации от 4-го и требует высшего образования — бакалавриата, желательно по направлению «Информатика и вычислительная техника» . На практике работодатели смотрят на портфолио и опыт: вакансии в IT-компаниях часто не требуют профильного диплома, но требуют «опыт работы 3–6 лет» или «подтверждённые навыки» .

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

Где учиться и сколько это стоит

Путей входа три: профильная переподготовка (от 2 до 6 месяцев, стоимость в региональных центрах от 30 000 до 80 000 ₽), самостоятельное освоение с портфолио на GitHub (0 ₽, но дольше и без обратной связи) и переход изнутри компании (редактор, поддержка, тестировщик — самый быстрый путь, если вы уже в продукте). Курсы дают структуру и разбор работ, но не заменяют практику на реальном или учебном стенде. Освоить смежную профессию поможет дистанционная переподготовка на оператора электронно-вычислительной техники.

Портфолио без опыта и первая работа

Портфолио без опыта собирается из трёх вещей: инструкция к чему-то, что можно проверить (например, гайд по настройке бесплатного облачного сервиса с шагами и скриншотами), справочник методов открытого API (публичная спецификация Stripe или GitHub — тренировочная база) и отредактированный фрагмент чужой документации с обоснованием правок. Первая работа чаще всего находится через сообщества технических писателей и внутренние вакансии компаний, где вы уже работаете в другой роли.

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

Зарплата технического писателя в Москве на позиции с опытом 3–6 лет доходит до 250 000 ₽ в месяц, в регионах и на удалёнке джуниор стартует с 60–80 тысяч ₽, а разрыв между направлениями определяется не столько городом, сколько сложностью продукта: API-документация и ГОСТ платят больше, чем пользовательские статьи для массового сервиса.

Верхняя граница зависит от знания английского (документация для международного продукта), опыта работы с облачными платформами и умения выстраивать docs-as-code процесс с нуля, а не только писать тексты . Источник: hh.ru, выборка по вакансиям «технический писатель», март 2026.

Зарплата по регионам и форматам работы

Удалёнка сравняла вилки для крупных IT-компаний: техпис из Твери, работающий на московский продукт, может получать столичные деньги, если его берут в распределённую команду . Региональные компании и промышленные предприятия платят меньше, но реже требуют работы в выходные и чаще предлагают гибрид. Фриланс даёт свободу, но нестабилен: стоимость часа на начальном уровне — 500–800 ₽, а поиск заказчиков занимает до половины рабочего времени.

Где работать техническим писателем и как выбрать работодателя

Технический писатель может работать в продуктовой IT-компании, в промышленности, в интеграторе или на фрилансе, и выбор места сильнее влияет на будни, чем название должности. В продуктовой команде вы ближе к коду и релизам; в промышленности — к ГОСТ и бумажному документообороту; на фрилансе — к дедлайнам и самостоятельному поиску клиентов.

IT-компании, промышленность и другие сферы

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

Удалёнка, фриланс и офис: что выбрать

Удалёнка в IT — самый распространённый формат: вакансии Яндекса и других крупных компаний прямо указывают дистанционную работу и гибкий график от 20 часов в неделю . Офис или гибрид чаще встречается в промышленности и банках, где нужно физическое присутствие на стенде или доступ к закрытому контуру. Фриланс подходит тем, у кого уже есть наработанная база заказчиков: без неё первые 2–3 месяца уходят на поиск, а не на доход.

Вывод: если вам важна техническая глубина — идите в продукт; если важна стабильность и формальные требования — в промышленность.

Плюсы и минусы профессии технического писателя

Плюсы профессии лежат в области предсказуемости и востребованности: техпис нужен везде, где есть продукт сложнее блокнота, а результат его работы можно проверить, а не оценить «на вкус». Минусы — в необходимости постоянно догонять изменения и в том, что успех часто незаметен, пока что-то не сломается.

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

Ошибки новичков и их цена

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

Часто задаваемые вопросы (FAQ)

1. Нужен ли техническому писателю диплом для трудоустройства?Для IT-компаний диплом не обязателен, если есть портфолио и опыт. Для позиций с ГОСТ и промышленной документацией высшее техническое образование чаще всего стоит в требованиях.
2. Можно ли стать техническим писателем без опыта в IT?Да, если вы придёте из смежной роли — тестировщика, редактора, сотрудника поддержки — и покажете три проверяемых документа в портфолио. Полностью «с нуля» без технического бэкграунда путь займёт от 6 месяцев.
3. Заменит ли искусственный интеллект технического писателя?ИИ ускоряет черновики и перевод, но не проверяет соответствие продукту и не принимает решений о структуре. Компании, сократившие техписов в расчёте на ИИ, чаще возвращаются к найму, потому что качество документации падает без человека в цикле .
4. Сколько времени нужно, чтобы найти первую работу техписом?При готовом портфолио и активном поиске — от 1 до 3 месяцев. Без портфолио первый этап растягивается на полгода, потому что отклики уходят в пустоту.
5. Какие книги и ресурсы помогут освоить профессию?Практика важнее книг: начните с публичной спецификации OpenAPI и напишите по ней справочник. Для понимания стандартов документации читайте описания ЕСПД в открытом доступе, для стиля — руководства по документации от Google и GitLab.
6. Что спрашивают на собеседовании технического писателя?Просят показать портфолио и объяснить, как вы проверяли факты; дают тестовое — написать инструкцию по скриншоту интерфейса или найти расхождение в API-спеке. Спрашивают про Git и опыт работы с разработчиками.
7. Можно ли работать техническим писателем удалённо?Да, в IT это распространённая практика: вакансии Яндекса и других компаний прямо указывают удалёнку и гибкий график .

Подтвердите квалификацию технического писателя вместе с «Обучим Специалиста»

Требования к техпису в вакансиях расходятся: где-то достаточно портфолио и знания Markdown, а где-то ждут понимания ЕСПД и опыта работы с OpenAPI. Разрыв между «умею писать тексты» и «могу сдать документацию, которую примет разработчик и комиссия», закрывается практикой на реальных или учебных задачах — и именно на это стоит смотреть при выборе программы. Обучение даёт структуру: разбор стандартов, работу с инструментами docs-as-code, тренировку на примерах API и разбор типичных ошибок, за которые снимают на испытательном.

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

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