6 минутСегодня IT-продукты становятся сложнее, поэтому крайне важно создавать понятную и подробную документацию к ним. Именно эту задачу решает технический писатель.
Технический писатель: кто это чем он занимается
Технический писатель — это связующее звено между разработкой, бизнесом и пользователями. Он создает необходимую документацию для IT-продукта и объясняет сложные концепции простым языком, понятным целевой аудитории. Это может быть как внутренняя документация для сотрудников компании, так и внешняя для клиентов. Также технический писатель должен постоянно поддерживать и обновлять существующую документацию, если продукт меняется.
Важно понимать, что технический писатель — это не копирайтер, он ничего не продает. Его задача — обеспечить комфортную коммуникацию между бизнесом, разработкой и пользователями.
С кем взаимодействует технический писатель
Чтобы эффективно выполнять задачи, технический писатель должен не только самостоятельно изучать особенности продукта и его архитектуры, но и тесно сотрудничать с проектной командой.
Проектный менеджер — с ним технический писатель координирует работу и контролирует соблюдение сроков.
Разработчики и инженеры — они дают детальное описание работы продукта, а писатель переводит это на понятный пользователю язык.
Менеджеры и маркетологи помогают понять целевую аудиторию продукта, ее потребности и ожидания.
Тестировщики указывают какие области технической документации требуют доработки.
Аналитики — работа с ними важна при создании внутренних документов для разработчиков, так как технический писатель передает продуктовую логику и концепцию.
Финансисты — вместе с ними технический писатель создает документацию для оплаты услуг и участвует в приемке работ заказчиком.
Какие документы создает технический писатель
Технический писатель работает с разными видами документации. Все зависит от целей конкретного проекта.
Пользовательская документация — юзер гайды, FAQ, инструкции по установке и не только. Ориентирована на внешних пользователей.
Техническая документация — спецификации, требования, API-документация, Release Notes (заметки о новых версиях), README-файлы для репозиториев. Используется разработчиками и инженерами.
Внутренняя документация — регламенты для сотрудников, онбординг-материалы и корпоративные базы знаний. Необходима для эффективной работы компании.
Главная цель любой документации — чтобы читающий смог выполнить поставленную задачу самостоятельно, без дополнительных подсказок. Это улучшает пользовательский опыт и оптимизирует работу компании.
Навыки технического писателя
Hard Skills
Инструменты для создания документации:
Системы управления контентом (CMS) — помогают создавать, редактировать и управлять контентом на веб-ресурсах без использования программирования (Jira, Confluence, Google Workspace).
Системы управления версиями (VCS) — обеспечивают удобное совместное ведение проекта и помогают отслеживать вносимые изменения (Mercurial, Git, Perforce).
Системы работы с API-документацией — используются, чтобы создавать, управлять и тестировать техническое описание интерфейсов прикладного программирования (Postman, Jekyll, Swagger).
Языки разметки (HTML, XML, Markdown) — нужны, чтобы оформлять документацию под требования разных ресурсов.
Графические редакторы — они помогают не просто создавать подробные тексты, но и делать документацию наглядной, визуализировать сложные концепции и иллюстрировать процессы (Figma, Inkspace, GIMP);
Принципы SEO — позволяют улучшить видимость документации в поиске и сделать ее удобнее для пользователей.
Soft Skills
Критическое и структурное мышление — умение упорядочить сложные технические принципы и объяснить их неспециалисту.
Скрупулезность — при подготовке документации технический писатель не должен упустить никакие детали.
Тайм-менеджмент — соблюдение сроков, грамотная расстановка приоритетов и согласованная работа с командой.
Коммуникабельность — технический писатель не может подготовить документацию в одиночку, нужно активно взаимодействовать с коллегами.
Настойчивость — умение добиваться нужной информации от других членов команды.
Где работает и сколько зарабатывает технический писатель в IT
Потребность в этой профессии растет: на момент написания статьи на HeadHunter открыто более 450 вакансий на должность технического писателя по стране.
Технические писатели нужны в крупных продуктовых IT-компаниях, стартапах и enterprise-проектах. Они создают инструкций и гайды для пользователей, базы знаний и API-документацию — это снижает нагрузку на техподдержку и упорядочивает внутренние процессы. Часто технических писателей привлекают для конкретных задач на фрилансе и аутсорсе. Такой формат позволяет брать несколько проектов, самостоятельно влиять на доход и работать с зарубежными заказчиками.
Зарплата технического писателя зависит от его опыта, квалификации, уровня компании и формата работы.
Junior технический писатель в небольшом региональном IT-стартапе будет зарабатывать до 50–80 тысяч рублей. Специалист с той же квалификацией в крупной компании в столице может получать до 100 тысяч рублей. На аутсорсе у зарубежных заказчиков — от $1000 до $1500.
Технические писатели с опытом до трех лет в регионах могут претендовать на зарплату до 130 тысяч рублей. В Москве и Санкт-Петербурге верхняя граница зарплатных ожиданий держится около 170 тысяч рублей. На аутсорсе за рубежом они получают от $1500 до $2500.
Прокаченные специалисты уровня Senior зарабатывают до 200 тысяч рублей в регионах и до 250 тысяч рублей в столицах. Зарубежные компании предлагают таким специалистам до $4000.
Технические писатели, которые доросли до тимлида или менеджера, могут получать до 350 тысяч рублей в России и до $7000 при работе с зарубежными заказчиками.
Как стать техническим писателем и куда расти
От других IT-специальностей технического писателя отличает отсутствие жестких требований к профильному образованию. Стать техническим писателем можно как с нуля, так и перейдя из смежных ролей. Успешно работают и выпускники гуманитарных факультетов, и IT-специалисты.
Филологам нужно получить хорошую техническую базу, чтобы разбираться в продукте.
Можно пройти специализированные курсы или программу переподготовки.
Часто в профессию приходят из смежных ролей, например тестировщики или специалисты техподдержки. Они начинают участвовать в создании документации в рамках своей компетенции и со временем вырастают в полноценных технических писателей.
Начинающим стоит:
собрать качественное портфолио с разными типами документов;
освоить необходимые инструменты и системы;
изучить современные стандарты технической коммуникации и регулярно их обновлять;
вступить в профильные сообщества, участвовать в конференциях и форумах, помогать с документацией на open-source проектах.
У любого технического писателя есть несколько вариантов карьерной траектории:
Вертикальный рост — самый распространенный тип развития в профессии, который предполагает увеличение зоны ответственности.
Junior создает базовые инструкции и FAQ, работает под контролем.
Middle самостоятельно ведет проекты и взаимодействует с разработчиками.
Senior глубоко разбирается в специфике, становится наставником для младших сотрудников.
Lead проверяет документацию, следит за соблюдением стандартов.
Менеджер управляет командой технических писателей и определяет стратегию.
Развитие специализации — при таком варианте карьерного роста технический писатель становится экспертом в определенном виде документации. Он может стать специалистом по API-документации, UX-редактором или информационным архитектором.
Смежные направления — это переход в другие профессии. Опыт технического писателя помогает стать аналитиком, контент-стратегом или продакт менеджером.
Кому подходит профессия технического писателя
Профессия технического писателя подходит тем, кто любит работать с текстами, скрупулезен, внимателен к деталям, умеет объяснять сложные концепции простыми словами.
Больших успехов добиваются гуманитарии с интересом к IT. Они обычно грамотно излагают мысли и готовы погружаться в специфику продукта.
Технический писатель — важный член проектной команды, без которого сложно представить успешный проект. В этой профессии нет единых требований к образованию и скиллам: каждый проект уникален. Поэтому достичь успеха могут люди с разным стартовым набором знаний, опыта и личных качеств.
