Документацию к продукту нередко пишут те, кто его создает: разработчики, менеджеры, аналитики и специалисты по документообороту. Для них это дополнительная задача рядом с основной, и тексты часто получаются неполными или сложными для пользователей.
Если таких текстов много, компания может нанять отдельного специалиста, технического писателя. Он отвечает за то, чтобы по документации можно было разобраться в продукте и выполнить задачу без помощи его авторов.
В статье рассказываем, кто такой технический писатель, какие документы он пишет, чем отличается от копирайтера, какие навыки ему нужны, сколько зарабатывает по данным опроса и где учиться этой профессии.
%201.png)
- Кто такой технический писатель и зачем он нужен
- Какие документы пишет технический писатель
- Чем занимается технический писатель и его обязанности
- Отличия технического писателя и копирайтера
- Что должен знать и уметь технический писатель
- Плюсы и минусы профессии
- Сколько зарабатывает технический писатель
- Доход технического писателя по регионам и инструментам
- Как стать техническим писателем и где учиться
- Коротко о главном
Кто такой технический писатель и зачем он нужен
Технический писатель — это специалист, который готовит инструкции, руководства и другие документы для пользователей и сотрудников компании, чтобы им было проще разобраться в сложной технической информации. Роль технического писателя в работе над проектной документацией разбирает научная статья на КиберЛенинке.
Технический писатель нужен там, где в работе используется много схем, чертежей, таблиц, макетов, присутствуют сложные технические процессы, применяются инновационные или редкие технологии и все это требует сопровождающей документации. Он собирает сведения у разработчиков и специалистов и превращает их в текст, который понятен тем, кто с продуктом не знаком.
Какие документы пишет технический писатель
Набор документов зависит от задачи читателя, например установить продукт, обслужить устройство или подключиться к API (программному интерфейсу продукта). К любому документу добавляются схемы, макеты, графики, таблицы и скриншоты, а при необходимости технический писатель выполняет технические переводы документации с другого языка.
| Документ | Для кого | Что в нем |
|---|---|---|
| Руководство пользователя, инструкция по установке и обслуживанию | Пользователь продукта, мастер по обслуживанию | Установка, настройка и порядок работы с продуктом |
| Документация для разработчиков и API | Разработчики, которые подключаются к продукту | Работа с программными интерфейсами продукта |
| Внутренняя база знаний, документация внутренних систем и устройств | Сотрудники компании и поддержка | Описание процессов, систем и устройств |
| Гайды для новых специалистов, сценарии обучающих материалов | Новые сотрудники и слушатели | Порядок обучения и вводные инструкции |
| Релиз-ноты | Пользователи и команда продукта | Что изменилось в новой версии |
| Техническое задание на разработку системы или сайта (в части проектов, в том числе по ГОСТ), паспорт изделия | Заказчик, исполнитель и специалист, который эксплуатирует изделие | Требования к разработке; сведения об изделии |
Чем занимается технический писатель и его обязанности
Технический писатель должен хорошо разбираться в продукте, который описывает, качественно собирать данные и общаться с разработчиками, грамотно анализировать и структурировать полученную информацию. Его обязанности начинаются с вопросов к тем, кто создал продукт, и не заканчиваются публикацией. Чем лучше писатель знает продукт, тем точнее вопросы, которые он задает специалистам.
Порядок работы над документом состоит из семи шагов:
- Выяснить цели и задачи написания текста.
- Определить целевую аудиторию и уровень знакомства с продуктом. Например, руководство пользователя МФУ и руководство мастера по обслуживанию этого же МФУ — это тексты с разной проработкой деталей. В первом случае понадобится объяснить базовые понятия, а во втором — акцент будет на деталях и сложных процессах: например, порядок обслуживания роликов подачи бумаги.
- Прописать и согласовать план документа.
- Разобраться в деталях и особенностях продукта. Задать вопросы специалистам и разработчикам, изучить имеющиеся данные, протестировать продукт.
- Написать текст с чертежами, схемами, скриншотами, таблицами и комментариями.
- Отправить готовый текст на вычитку и корректуру, проверить итоговый вариант.
- Обновлять документ после релизов и при изменениях продукта.
Седьмой шаг важен не меньше остальных. По принципам сообщества Write the Docs, неверная документация хуже отсутствующей, а когда продукт меняется быстрее документации, страдают пользователи. В опросе State of Docs 2026 платформы GitBook, где участвовали более 1100 специалистов по документации, 30 % респондентов назвали главной рабочей проблемой синхронизацию документации с продуктом.
Закладывайте правку документации в оценку задачи на изменение продукта: так обновление не остается на потом.
%201.png)
%201.png)
%201.png)
Отличия технического писателя и копирайтера
Технический писатель и копирайтер различаются целью текста. Цель технического писателя — помочь пользователям или специалистам разобраться в продукте и выполнить задачу, поэтому он готовит инструкции, руководства и другие вспомогательные документы. Копирайтер пишет тексты для продвижения и продаж, и его задача — повысить продажи, привлечь новых клиентов или повысить узнаваемость бренда. Форматы у него могут быть любыми: от текстов для соцсетей и рассылок до публикаций на сайте или внешних площадках.
Технический текст строится на четкой структуре, понятных пошаговых инструкциях и алгоритмах. Тексты для продвижения и продаж остаются задачей копирайтера, а технический писатель отвечает за точность и ясность описания продукта. Копирайтеру тоже нужен понятный документ на входе — ТЗ на текст; как по такому ТЗ копирайтеры клиента пишут статьи для блога, показывает кейс Autorepar.
Что должен знать и уметь технический писатель
Специальность технического писателя техническая, но гуманитарные навыки в ней требуются ничуть не меньше, и от обоих зависит качество документации. Среди популярных требований можно выделить следующие умения:
- быстро находить и проверять информацию, упорядочивать и структурировать большие объемы данных;
- объяснять простыми словами сложные вещи;
- интервьюировать специалистов и задавать точные вопросы;
- составлять схемы, чертежи, макеты, графики и таблицы, работать с графическими программами;
- читать документацию на иностранных языках;
- понимать правила документирования и стандарты оформления, в российских проектах это нередко ГОСТ 19 (единая система программной документации) и ГОСТ 34 (автоматизированные системы);
- работать с Markdown и Git;
- разбираться в основах API-документации;
- создавать презентации и обучающие ролики.
Остальные требования касаются личных качеств: работа в команде, способность быстро обучаться, многозадачность и дисциплина.
Docs as Code — это подход, при котором документацию пишут теми же инструментами, что и код: трекером задач, системой контроля версий Git, текстовой разметкой вроде Markdown, ревью и автотестами. В опросе русскоязычных техписателей, который провел documentat.io в начале 2024 года, Git для документации используют 38 % из 365 респондентов, а Markdown — 30 %.
Искусственный интеллект (ИИ) стал рабочим инструментом специалистов по документации. В мировом опросе State of Docs 2026 платформы GitBook 76 % специалистов по документации регулярно используют ИИ в рабочем процессе, а 56 % из них тратят меньше времени на написание и больше на редактирование и проверку текста.
Плюсы и минусы профессии
Профессия сочетает постоянное развитие с большим объемом рутины, и это стоит учесть при выборе.
Плюсы:
- возможность работать удаленно;
- постоянное профессиональное развитие и изучение нового;
- варианты карьерного роста.
Минусы:
- сложность профессии;
- большое количество рутинных процессов и монотонной работы;
- ответственность за точность информации и ее доступность для понимания.
Сколько зарабатывает технический писатель
Данные о зарплатах технических писателей в России дал опрос documentat.io, который проходил с конца декабря 2023 по конец января 2024 года. На вопросы ответили 365 русскоязычных техписателей. Медианная зарплата штатных сотрудников, живущих в России, составила 120 000 ₽ в месяц на руки, после вычета налогов и отчислений. В Москве медиана равна 140 000 ₽, в регионах 100 000 ₽, а 95-й процентиль достигает 240 000 ₽. Фрилансеры, которых среди респондентов было 9 %, в расчет не вошли.
Сопоставляя вакансию с этими цифрами, берите ту же базу — регион, штатную занятость и сумму на руки — и помните, что опрос прошел в начале 2024 года.
Доход технического писателя по регионам и инструментам
В опросе documentat.io 85 % респондентов живут в России. Медианы различаются по региону: в Москве выше, чем в регионах. Различаются они и по инструментам: у тех, кто пишет документацию по подходу Docs as Code, медиана составила 150 000 ₽ в месяц на руки, у пишущих в Word без этого подхода 85 000 ₽.
Как стать техническим писателем и где учиться
В профессию приходят тремя путями, и выбор зависит от образования и опыта, которые уже есть. Специалист с техническим образованием, которому не подходит работа по основной специальности, знает продукт и понимает процессы, поэтому может описывать их в документации. Тем, кто работает в смежной IT-области, например веб-разработчикам, достаточно актуализировать знания: пройти курсы или изучить литературу. Гуманитарию, который решил сменить область, нужно освоить профессию с нуля, на курсах или по книгам и другим обучающим материалам, и научиться разбираться в технических темах. Обучение на технического писателя строится на профильном или смежном образовании, курсах и самостоятельной подготовке.
Соберите портфолио из двух-трех документов разных типов: руководство, статья базы знаний и описание API.
%201.png)
.jpg)
Книги для самостоятельного знакомства с профессией
Книги ниже помогают освоить письмо, редактуру и документирование программного обеспечения.
- Уильям Зинсер «Как писать хорошо. Классическое руководство по созданию нехудожественных текстов». Классическая книга о письме: рассказывает, как писать нехудожественные тексты любых форматов.
- Денис Каплунов. «Бизнес-копирайтинг. Как писать серьезные тексты для серьезных людей». Книга о деловых текстах: учит писать живые и интересные тексты.
- Вадим Глаголев. «Разработка технической документации. Руководство для технических писателей и локализаторов ПО». Рассказывает о написании документации на ПО, соблюдении стандартов, разбирает основные виды техдокументов. Будет полезна локализаторам и переводчикам.
- Т.А. Макаровских. «Документирование программного обеспечения. В помощь техническому писателю. Учебное пособие». Рассказывает о важности документирования и работе техписа, рассматривает виды документации, стандарты и знания, которые требуются автору техдокументации.
- А. В. Михайлов. «Профессия Технический писатель, или Рыцари клавиатуры. Базовые сведения. Приемы работы с текстом и программным обеспечением». Содержит основные аспекты работы техписа и его путь от новичка до профессионала, подойдет тем, кто только собирается освоить профессию.
- Аркадий Мильчин. «Методика редактирования текста». Книга о редактуре: рассматривает технические приемы редакторского анализа нехудожественных текстов.
- В.В. Липаев. «Документирование сложных программных средств». Дает структуру и шаблоны для документирования сложных систем, ориентирована на руководителей крупных проектов и разработчиков.
- Алан С. Прингл, Сара С. О'Киф. «Technical Writing 101: A Real-World Guide to Planning and Writing Technical Content, Third Edition». Рассказывает о том, чем занимается техпис, с какими трудностями сталкивается и какие вопросы возникают чаще всего.
Стандарты, которые стоит изучить
Ниже указаны действующие редакции международных стандартов и российский ГОСТ на программную документацию.
- ISO/IEC/IEEE 26514:2022. Systems and software engineering. Разработка систем и программ. Проектирование и разработка информации для пользователей
- ISO/IEC/IEEE 26511:2018. Systems and software engineering. Разработка систем и программ. Требования к управляющим документацией для пользователя
- ISO/IEC/IEEE 26515:2018. Systems and software engineering. Системная и программная инженерия. Информация для пользователей в гибкой среде разработки
- ISO/IEC/IEEE 29119-3:2021. Шаблоны документации для тестирования программного обеспечения. Часть серии ISO/IEC/IEEE 29119, которая заменила IEEE Std 829-2008.
- ISO/IEC/IEEE 29148:2018. Спецификации требований к программному обеспечению. Преемник IEEE Std 830-1998.
- ГОСТ 19.101-2024. Единая система программной документации. Виды программ и программных документов
Курсы для технических писателей
Курсы бывают разных форматов: от повышения квалификации до профессиональной переподготовки.
Учебные курсы для технических писателей от documentat.io. Среди программ «Документирование современных ИТ-решений по российским стандартам», «Документируй как инженер: практический курс Docs as Code» и «Ревью документации».
Курс повышения квалификации «Технический писатель. Разработка и оформление технической документации» от Учебного комплекса ЦНТИ «Прогресс».
Курс «Как стать техническим писателем» от АНО ДПО «Учебный центр РРС».
Профессиональная переподготовка по программе «Технический писатель» от АНО «Профессиональный стандарт».
Курс «Технический писатель: создание технической документации» от центра «Специалист» при МГТУ им. Н.Э. Баумана.
Курс «Технический писатель» от Академии АйТи.
Коротко о главном
- Технический писатель отвечает за технические тексты для внутреннего и внешнего пользования: руководства, инструкции, базы знаний, документацию для разработчиков и релиз-ноты.
- Работа идет от целей и аудитории до проверки и обновления документа после релизов, а технического писателя от копирайтера отличает цель текста: помочь разобраться в продукте.
- Нужны умение находить и структурировать информацию, объяснять сложное простыми словами и работать с инструментами вроде Git и Markdown.
- По опросу documentat.io начала 2024 года медианная зарплата штатных техписателей в России составила 120 000 ₽ в месяц на руки.
- В профессию приходят из технической, смежной и гуманитарной сфер через курсы, книги и стандарты, а портфолио из двух-трех документов помогает показать навыки.
.png)
.png)
Комментарии (3)
Оставить комментарий