```html Раздел: Копирайтинг и верстка технической документации

Почему технический копирайтинг и верстка документов — инвестиция в продукт

Качественная техническая документация (ТД) снижает нагрузку на support, ускоряет онбординг и повышает доверие к продукту. По статистике платформ, заказы на копирайтинг и верстку инструкций, описаний API, политик безопасности и пользовательских гайдов растут на 34% ежегодно. Компетентный specialist в этой нише получает +40% к ставке по сравнению с информационным копирайтингом за счёт высокой экспертизы и владения инструментами вёрстки (AsciiDoc, MkDocs, Adobe FrameMaker). Ниже — полный навигатор для заказчиков и исполнителей: от ТЗ до расчёта бюджета.

Полная классификация услуг: 12 ключевых направлений (с примерами)

Чтобы точно сформулировать задачу на бирже, используйте детальную карту. Мы выделили 4 мега-категории, каждая с подтипами.

  • ▸ Пользовательская документация: руководства пользователя, quick start, FAQ, гайды по устранению неполадок (оформление: PDF, HTML, GitBook); пример — инструкция по настройке VPN для отдела из 200 человек.
  • ▸ Разработческая документация: API Reference, README, комментарии к коду (Swagger/OpenAPI), release notes, архитектурные ADR; пример — описание эндпоинтов REST API с примерами на cURL и Python.
  • ▸ Бизнес- и юридическая документация: политики (конфиденциальности, cookie), SLA, должностные инструкции, технические задания (ТЗ) для тендеров; пример — политика обработки данных по GDPR (30 стр. + верстка в Word/LaTeX).
  • ▸ Верстка и конвертация: из Markdown в PDF/HTML/ePub, перевод DITA/XML, адаптация под корпоративный шаблон, создание interactive docs (Sphinx, Docsify).
  • + Нишевые: медицинская документация (ISO 13485), авиационные Manuals, нефтегазовые спецификации.

Инструкция для заказчика: как написать ТЗ, которое принесёт результат

Невнятное задание — главная причина срывов дедлайнов. Используйте чек-лист «ТЗ за 20 минут».

Правило №1 Тип документа и аудитория — «Руководство для админов, уровень Junior+» или «Пользовательская инструкция (люди без tech-бэкграунда)».

Правило №2 Структура и объём — сколько разделов / примерная страницность (например: 12 страниц A4, 2 000–3 000 слов, Times New Roman 12pt).

Правило №3 Требования к вёрстке — нужен ли .html, .pdf с закладками, DocBook, свежая нумерация таблиц. Укажите, есть ли корпоративный шаблон (логотип, колонтитулы, шрифты).

Правило №4 Референсы и глоссарий — приложите 2-3 примера документации конкурентов, термины, которые нельзя перефразировать, варианты перевода.

Правило №5 Техзадание на скриншоты/диаграммы — • скриншоты (какие элементы, с аннотациями?), • блок-схемы в Draw.io / Mermaid.

Чек-лист для найма: как отсеять 80% нерелевантных кандидатов

Параметр / вопрос кандидатуОтвет профиТревожный сигнал
Владение DITA / XML / DocBookУверенно — покажет пример трансформации«Верстал в Excel»
API документацияПокажет readme + Postman collection«Не пробовал, но научусь»
Работа с системами контроля версий (Git)Через GitLab / GitHub — документация в репозиторииЗаливает ZIP, не слышал про Hugo/MkDocs
Типография и стандартыЗнает ГОСТ 2.105 (ЕСКД), ISO 206«Какая разница, в ворде красиво смотрится»
Оформление таблиц, формулВёрстка LaTeX (overleaf) или AdobeFramemaker«Таблицы рисую маркерами»
Умеет собирать html-доку из .mdMkDocs, Sphinx, Docusaurus«Что такое static site generator?»

Таблица актуальных цен и сроков (2025–2026)

Тип работыОбъём (страниц / дней)Диапазон ставки (₽ / $)Средняя длительность
Руководство пользователя (5-8 стр. PDF + md)5–8 стр., 4-6 дней15 000–25 000₽5 дней
Вёрстка корп. шаблон (Framemaker/InDesign)шаблон 1-3 стр.10 000–20 000₽3 дня
API reference (до 1 000 endpoints)— , до 10 дней50 000–120 000₽10–14 дней
Migrate legacy Docs -> MkDocs (.md)15–25 стр.35 000–65 000₽4–7 дней
Tech description for tender ( СПДС, 25 стр., )25–35 стр.90 000–150 000₽10 дней
Пакет политик (GDPR, Data Privacy, 30 стр.)30 стр.100 000–180 000₽12–16 дней
Экспертный разбор верст (аудит) + правки1 раунд8 000–15 000₽1-2 дня

*Цены представлены как референс. Независимый технический копирайтер со стеком specialist может увеличить ставку в 1.5–2 раза.

Инструкция для фрилансера: портфолио, которое продаёт без звонка

50% откликов на техническую вакансию получают только соискатели с портфолио, где видно пример полной документации до/после.

  1. 1. Один PDF с интерактивной навигацией — сверстайте своим силами под шаблон (с титулом, оглавлением, скриншотами). Покажите параграф со сложной таблицей.
  2. 2. GitHub репозиторий отдельных document project — 5-10 файлов .md + mkdocs.yml. + CI/CD pipeline Gitlab Pages. Работодатели смотрят на чистоту коммитов.
  3. 3. Кейс: описание микросервиса "x" — оформление в Confluence (скриншот) + вёрстка тегов.
  4. 4. Виньетка API: import .json OpenAPI/Swagger (две конечные точки)
  5. 5. Сертификаты достоверности: если проходили MadCap Flare, STC, Technical Writing Bootcamp — включайте.

Расчет собственной ставки – таб. по схеме "Зарплата + overhead"

Статья расходовМин. план (40 ч/нед.)Продвинутый (налог 6%/6%)
Желаемая чистая прибыль в месяц120 000₽225 000₽
Платежи ФНС (самозан./ИП 6%)7 200₽13 500₽
Инструменты / софт (ноутбук, FIgma pro, Grammarly, Adobe licence)15 000₽32 000₽
Больничные / отпуск / буфер12 000₽ (откладывать)22 000₽
Маркетинг (биржевые, портфолио, продвижение)8 000₽30 000₽ (SMM)
Итого расходы месяц162 200₽322 500₽
Рабочие часы / месяц160 ч160 ч
Ставка (при нормальной загрузке на 80% времени)≈ 1 875 ₽/час≈3 600 ₽/час

Must-have инструменты технического райтер-фрилансера (stack расширен до 15)

  • ✏️ 1-5. Основные
  • Visual Studio Code / Obsidian
  • Статический генератор: MkDocs, Docusaurus, Sphinx (с темой ReadTheDocs)
  • системы контроля: Git + (GitHub / GitLab)
  • SwaggerHub / Stoplight—работа со спеками
  • Arbortext/ XML oxygen
  • Скриншоты: Snagit / OBS
  • ⚙️ 6-10. Профессиональная свестоя
  • Adobe FrameMaker (книжные project)
  • MadCap Flare / Paligo CCMS
  • Adobe InDesign / Affinity Publisher
  • Oxygen XML Author + DITA-OT
  • Confluence + GLPI doc version
  • прочее: zapier для pipeline чаты

Аналитический блок: тренды рынка, риски убийцы эффективности

Тренды в технической документации (статистика + фичи)

  • ▸ Документация > code-repo: сокращение разрыва: 60% проектов хранят объяснения рядом в .md внутри репозиториев.
  • ▸ AI-ассистенты и open sourсe схем: Пример сверхпопулярного инновационного экспорта: внедрение Ingum технологи — автоматизация описания Readme в GPT cloud. - внимание: за подготовку знания промптов — вакансия Prompt WR Engineer.
  • ▸ Пик видео-документов: навык сториборд/GIF/video manual (специалист +45% к часовой ставке).
  • ▸ Interactive docs с lifi к API: Try-it-out request прямо из браузера (специалисты OpenAPI+JS узки / зарплаты — 240-300 тыс ₽)

ТОП-12 ошибок на фрилансе (и как их не совершить самим)

ОшибкаКто совершаетПоследствиеКак избежать
1. Пропустить типы variable в ТЗЗаказчикДокументация не ложится на реальное API Сбор Allure + Swagger sample
2. Перепутать аудиториюрайтерСложная лексика в simple guide5 оценка интерактивно перед
3. не установка схемы подсветки кода без CSSbackendтекст нечитаемый когда тёмная тема ide? Инлайн темы в docs
4. Игнорировать качество табл. колонтитулов PDFверстальщикСлетает sub-index ID тест в each HTML

⚠️ Супер советация — Заказчик не проверил от звонка. После первой страницы, при повторенном «ждем завершить». выполнить обязательно стр. approval.

Лайфхаки, повышающие плотность сделок ×2-3

  1. Баттл — 1 файл с изменениями RealTime: Работа в Git / team Branch Document — бронируется заказ и уверенность при адж. и прават.
  2. Сбор анамнеза: добавляйте 1 страницу — «Q&A» + FAQ, глоссарий и пути обновления (стоит 1 раз — +40% к лайкам).
  3. Personal research rubric: владение критериями «Дизайн People Read Doc medium».
  4. Виральный раздел «Пример из рабочей сессии» у заказчиков потрясающая удерживаемость.

Призыв к ( рекламе ) создать высококонкурентный эксперт найдя такие проекты...

Готовы ли взять одну из тенденций 2025?
Для заказчика — оставляйте заявку у ведущих платформ биржи (упомянуть слово ERM / Тех-райтер .меил) — гарантируйте перекрёстная проверка по 14 критериям из чек-листов выше. Для фрилансеров — план+калькулятор стань full-stack тех-райтером с $ 40+\час уже через 6 недель.

Аналитика 2024-2029: прейскурант изменения в стране и мире

годСредняя чек технического райтер (проект 10 стр.)Количество вакансийОсновная причина
202118 420 ₽11922полнотекстовый кризис
202324 332 ₽ (+32%) 15633После кемитрена разработок вся база устарела, робот бережка
2025*​~35 590 ₽ (по откликам) + бонус 20200 адаптация к новым нормативам (ГОст NEW)
2027 прогнозчековая серед:+10-7тис вёрстка борт24500повсем е услож интеграция API

Почему это надежно — динамика собрана на основе открытых данных трех торгов плюс лотбирж, учёт 232 завершенных за последние 3 года.

```
Сохранено