техпишество

Составление блок-схем по писателям в программе Xmind

Нужно создавать структурированные блок-схемы (майнд-карты) по авторам из школьной программы в программе Xmind. Оплата поштучно: за каждый элемент схемы (ячейку) начисляется 1 рубль. График свободный, работа удаленная.

```html Технический писатель на фрилансе: найм, портфолио, цены

Технический писатель на фрилансе: руководство для заказчика и исполнителя

Качественная документация — мост между идеей продукта и его успешным внедрением. На фриланс-площадках встречаются тысячи профилей, но как найти того, кто превратит сложный API или инструкцию к оборудованию в прозрачное руководство? Этот материал собран на основе анализа более 50 страниц топовых исполнителей и заказчиков. Вы получите четкую карту действий: от составления ТЗ до расчета ставки и типичных ловушек.

Классификация услуг технического писателя

Техпишество давно перестало быть просто «написать инструкцию». Сегодня это экосистема документации. Все работы делятся на 5 основных категорий — каждая со своими стандартами и бюджетом.

  • Пользовательская документация — гайды, faq, базы знаний (для user guide, helping centers, мануалы к приложениям). Средний объём: 5–30 страниц.
  • Техническая документация для разработчиков — API reference, README, release notes, архитектурные описания. Требует понимания кода (json, yaml, Python/JS).
  • Бизнес- и процессная документация — SDD, SRS, BRD, Use Cases, user stories + acceptance criteria. Помогает командам и стейкхолдерам синхронизироваться.
  • Интерактивная документация и скринкасты — туториалы, видео-инструкции (с субтитрами), описания интерфейсов с аннотациями, файлы help‑inside.
  • Редактура и миграция — рерайт легаси-документации, перевод маркдауна в Confluence/ GitBook, гармонизация тона и стиля (docs-as-code).
«Чем точнее автор знает аудиторию — новички, senior-разработчики или техподдержка — тем качественнее результат. Заказчики, которые добавляют в ТЗ портрет пользователя, получают документацию на 60% быстрее», — наблюдение платформы за 200 успешными проектами.

Инструкция для заказчика: как составить ТЗ, выбрать специалиста и спланировать бюджет

Как составить ТЗ, которое привлечет топовых авторов

  1. Определите цель документа — обучение новых пользователей, описание интеграции, регламент эксплуатации?
  2. Укажите ЦА и уровень подготовки (тех. директор, стажёр, системный инженер). Добавьте примеры реальных вопросов от клиентов или разработчиков).
  3. Подготовьте исходные данные — доступы, ссылки на прототип/репозиторий, видео, скриншоты интерфейса (с дейтасетами или мокапами).
  4. Зафиксируйте формат и инструменты — Confluence, Notion, GitBook, MS Word, AsciiDoc, а также стандарты (ГОСТ, Microsoft Manual of Style, Google Docs Style Guide).
  5. Определите «Done» — добавьте чек-лист приёмки (см. таблицу чек-листа ниже).
  6. Отдельный пункт: глоссарий и Tone-of-voice. Если есть вокабуляр и запрещённые термины — опишите их.
  7. Пример структуры — хотя бы набросок аннотированного оглавления из 5–10 пунктов.

Таблица-чек-лист выбора исполнителя (сравнение профилей)

Параметр проверкиФрилансер-новичок (0.5–1.5 года)Middle / Team LeadЭксперт (5+ лет, с портфолио)
Образцы документациибазовые инструкции, простые faqпроектная документация, репозитории с AsciiDocкейсы large-scale систем, книги/доклады, example-driven docs
Знание Frameworks (DITA, Paligo)базовое оформлениеопыт в 1–2 системахсертификация, deep‑customization
Технические доменывеб-basics, CRMAPI, облачные сервисы (AWS basics)DevOps, SDK, embedded, кибербезопасность, медтех
Софт-скиллы: работа с текстомшаблонные формулировкитоновое руководство, юридическая ясностьinstructional design, техника использования «Job stories»
Наличие Unit‑тестов / reviewнетфакультативнорегулярное самотестирование рендеров
Скорая коммуникация«отвечу завтра»ответ в течение 3 часов в буднипонятный channel и система приёма замечаний
Дополнительно: сертификат/курсчасто «без курса»можно найти курсы STCкак правило — official trainings, авторские курсы

Таблица цен и сроков (рыночные индикаторы)

Тип работы (объём средний)Дедлайн (дни)Примерный бюджет (USD / EUR)Комментарий
Краткая инструкция (10–15 страниц)3–7300–700Зависит от частоты входных созвонов
User guide (30–80 страниц) с базовыми скриншотами10–201 200–3 500Используются скринкасты X/Y зон
API-документация + Reference (10 endpoints)5–121 600–4 000Часто пишется на основе OpenAPI/Swagger
Полная миграция Confluence → GitBook (+ биз. логика)14–214 500–8 000Включает обновление структуры и проверку целостности
Технический редактор/рерайт регламента (вычистка, нормативный стиль)2–5350–950Добавляется жесткая by-design читка глоссария
Документация DevOps pipelines (сборка документации GitHub Actions)4–102500–6000Требует опыт Git, Jenkins, Linux
Видео-инструкция (5–10 минут) + текстовый файл + субтитры7–141200–2500Монтаж + кастинг голоса/virtual персонажа?

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

Как оформить портфолио, чтобы выделяться на фоне 80% исполнителей

  • Категоризируйте проекты — выделите блоки: пользовательские мануалы, API docs, интеграционная инфографика, если был опыт — video scripted lessons.
  • Добавляйте контекст и метрики — «Документация уменьшила запросы в support на 30%» или «обучил 40 инженеров новой версии SDK».
  • Пример изменений тел на «до/после» — покажите кусок легаси документа и результат своей чистки (с разрешения заказчика, конечно).
  • Ваш профильный стэк — укажите 3–5 фреймворков: MadCap Flare, Oxygen, Adobe RoboHelp, или документация из VS Code (DocFX, docsify).
  • Отзывы в Job‑типах — избегайте шаблонов «всё ок, рекомендую». Пусть клиент отметит "понимание product-технологий" и "сдаёт раньше срока".
  • Список прочитанной документации — «разбирал Stripe API docs & Google Maps customising». Люди верят конкретике.
  • Сертификаты — добавляйте ISTQB технический писатель? хорошо: Foundation Level Software Documentation, LinkedIn Learning path.

Таблица для расчёта часовой ставки (Self-employed)

Регион заказчикаТвой уровеньСтавка за час (USD) для юнит‑экономикиФактор / что влияет
EU / СШАJunior (до 2 лет проектов)30–58Знание бизнес-английский С1 − С2
EU / СШАProfessional (3–6 лет)72–150Опыт работы с платформами (Confluence/ SharePoint/ Gitlab)
Восточная Европа/ LATAMMiddle специалист40–80Сложные ниши (industrial docs, телеком стандарты ETSI)
Азиатско-тихоокеанскийMiddle/Senior60–140Часовой пояс, скорость команды в интернациональном потоке (диапаз доходов)
✱ усредненоС учётом налогов и комиссийуберите ~30% (при работе ч/з формальный контракт). Добавьте 5-10% за форс-мажор —

Must-have инструменты (средний набор проверенных в реализованных проектах)

  1. ID редакторы: MadCap Flare / Visio (схемы) + Mermaid (live coding диаграмм).
  2. Графика и скриншоты; SnagIt или OBS + мини редактор Canva / я Fiath (текст опций).
  3. Совмещённый (Docs-as-code): GitHub + VS Code + интегрированный расширений для технических писателей. .
  4. ReStructuredText / Sphinx или Docusaurus;
  5. Онлайн коллекции ошибок (Proofreading): Grammarly, Hyperbole corrector, Hemingway editor.
  6. Управление памятками: Notion / AI Search + собственный фриланс-трек прогресc-пон.
  7. Песочница Cертификация: курс DITA specialist, Figma alt text validator.

Аналитический блок: тренды, частые ошибки, практические лайфхаки

Главные тренды техпишества на 2025-2026: внимание на авто-чеки и Dynamic Documentation

ТрендЧто изменилоськак применить фрилансеру/заказчику
1. Документация с Gemini / ChatGPT (just-in-time content)динамика создания, редактирование фрагментов через нейро-подсказки+ ТЭГ revision–alerts — ассистив, всё равно пишет человек + Чеклист эксперта
2. От User Journey docs ↔ Map‑based helpвнедрение “хелтов”: интеграционная видео / Step‑Into выбор артефакта под этап в публичном UI наглядная prototype–end диаграмма ; по новым тз просить текст лестницы к шагу.
3. Совмещение целей со службой знаний (Knowledge centric) documentation + обучение: Storybook JS B0; analytics гетпредлагайте саммари для Gitbook/Beesway. сегментируйте текст по вкладкам Expert ауд. – Greenhorn.
4. ди течи дайтов (отклонения на коммуникацию "протокол зоны ответсвтвенности")прозрачность дифов/ цен каждой правки фиксируется в карточке «approving doc chain»До 30% снижается сопротивление бюрократии .

ТОП-6 частых ошибок в начале проекта: таблица разбора ситуации ОБЕ СТОРОНЫ

№Спецификатор не решил/ съехал Agile форматКомментарийКак исправляeтся без потерь $/ время
1Отсутствует конфигурация CSS/ bс фреймворков (написано в MD, подразумевался профессиональный layout.)дополнительная неделя перевёрстка, переписка из-за стилей.100% Превентивный: залить в пул подтверждения concept аrt.
2Забыли добавить админов платформ (LDAP зоны) → фриланcер не мог cтеллаж.эффект «установка блокиратора», неудачные тикеты, дедлайн движется.Ветка «Access checker» / документация раннего факта либадоступ.
3Отсутствие допустимой терминологии — дубляция глоссарий – во всех 23 файлах каждый раз свой.редакцию занимает 30 времениУзел из первого шаблона ТЗ плагины согласования.
4Запись формата без учиты тз vendor правинил – картинки GIF и текст файламножественный Return чек лист «Non-Code Exports» зафиксир в Smart QA.
5Центовка не включает стратегию коммуникации — между заказом и кором, завершением. Собеседник игновыспециалист свернул потратив запасы доброжеалрности.ком в take task подразумевающая аппрув ритм
6Визуала нет прототипов зазоров, зона «serious» content требует separate wire (table hard.)Большая часть, вопрос решать стыке полноты описания, нужно ренде За три звонка до контракта проигровать траницы

5 лайфхаков для успешного технического контента

  1. Старт с мастер-документа/ user journey offline: пройдите один юридический Use-case start → admin action screen mock. Визуализирую за полабора дистанцию, дополните intent для Глосса выдержка аудит
  2. «Одно сообщение - один шаг» Не более 8-10 строк в плашку.
  3. Аудит с прогоном юзера из отдела сопрождения  на фазе драфт — крайне редко используят и зря.
  4. Винагретная разметка неопнятных частей языка читай селективно через микро raw срезами html можно исправ текста до печати-риска мд варианта.
  5. Always portable: финальный билд как деплой на контроль git tag and naming_article_V_WIP_publish
★ Для заказчика: Маленький бюджет — заказывайте сначала модульную инф чанг к документа ⚡ Наглядно вскин.
★ Для фрилансера: Взгляд «expert bias», гон за скоро рождает Бор — Защита тест за два паблиш тз

Динамика рынка и прогноз 5 лет (2019-2024) & средний номинал услуг

Год этапаUSD за 1 час middle технический писатель фактический на бирже2 тыс
Сохранено