Что нужно знать техпису 2.0
1. Docs-as-Code — документация как код Документы теперь живут в Git, проходят ревью и обновляются через CI/CD. Знание Git и понимание процессов DevOps помогают писать живую и актуальную документацию.
2. Markdown и разметка Markdown остаётся стандартом, но важно уметь больше: AsciiDoc, XML, DITA и другие форматы — в арсенале современного специалиста.
3. API-документация Главный скилл 2025 года. Понимание REST, JSON и структуры API делает техписа ценным партнёром для разработчиков.
4. UX и дизайн Документация — часть пользовательского опыта. Техпис участвует в разработке интерфейсов и помогает сделать продукт понятным без лишних слов.
5. Лёгкий DevOps Понимание принципов CI/CD, облаков и пайплайнов — уже не бонус, а стандарт.
Инструменты, которые стоит знать:
- Markdown, GitHub, Confluence, MadCap Flare, Docs-as-Code
- CMS и HAT-системы (help authoring tools)
- Базовый HTML и CSS
- ИИ-инструменты (GitHub Copilot, встроенные ассистенты)
Итог
Роль технического писателя сегодня — не просто “писать красиво”, а быть частью IT-процесса. Техпис 2.0 понимает код, UX и DevOps, умеет автоматизировать работу и делает документацию настоящей частью продукта.
Совет от эксперта: Освойте API-документацию и Docs-as-Code — эти навыки открывают двери в IT-команды и делают вас востребованным специалистом.
Главная мысль попала точно. Такие материалы хочется обсуждать, а не просто пролистывать.
Не со всем согласен, но аргументы сильные. Было бы интересно увидеть продолжение.
Люблю такие разборы: без громких обещаний, зато с понятной логикой.