Профиль навыка

Docs-as-Code

Docs-as-Code: MkDocs, Docusaurus, Antora, Markdown, CI/CD для документации

Документация Docs-as-Code

Ролей

где встречается этот навык

Грейдов

сформированная дорожка роста

Обязательных требований

ещё 0 — необязательные

Документация

Docs-as-Code

17.03.2026

Выберите текущий грейд и сравните ожидания. Карточки ниже покажут, что нужно закрыть для следующего уровня.

Чего ждут на каждом уровне

Таблица показывает, как меняется глубина владения навыком от Junior до Principal.

Роль	Обязательность	Описание
Technical Writer	Обязателен	Знает основные docs-as-code инструменты: MkDocs, Docusaurus, Sphinx, Hugo, Jekyll. Умеет настроить базовый documentation site из шаблона. Пишет документацию в Markdown, знает основы reStructuredText.

Роль	Обязательность	Описание
Technical Writer	Обязателен	Уверенно работает с 2-3 docs-as-code фреймворками. Настраивает navigation, search, versioning, custom components. Использует MDX/RST расширения, плагины для diagrams, code highlighting. Интегрирует docs build в CI/CD.

Роль	Обязательность	Описание
Technical Writer	Обязателен	Проектирует docs-as-code инфраструктуру для крупных проектов: monorepo docs, cross-project navigation, custom plugins. Разрабатывает кастомные компоненты (interactive API explorer, live code playground). Оптимизирует build performance и SEO.

Роль	Обязательность	Описание
Technical Writer	Обязателен	Определяет docs-as-code стратегию и стандарты для организации. Выбирает toolchain, определяет architecture docs platform. Координирует миграцию с legacy wiki (Confluence) на docs-as-code подход. Обучает команды работе с инструментами.

Роль	Обязательность	Описание
Technical Writer	Обязателен	Формирует долгосрочную стратегию documentation platform: выбор технологий, roadmap development, integration с developer ecosystem. Определяет инвестиции в documentation infrastructure и custom tooling.

Junior 1 требований

Technical Writer
Обязателен

Знает основные docs-as-code инструменты: MkDocs, Docusaurus, Sphinx, Hugo, Jekyll. Умеет настроить базовый documentation site из шаблона. Пишет документацию в Markdown, знает основы reStructuredText.

Middle 1 требований

Technical Writer
Обязателен

Уверенно работает с 2-3 docs-as-code фреймворками. Настраивает navigation, search, versioning, custom components. Использует MDX/RST расширения, плагины для diagrams, code highlighting. Интегрирует docs build в CI/CD.

Senior 1 требований

Technical Writer
Обязателен

Проектирует docs-as-code инфраструктуру для крупных проектов: monorepo docs, cross-project navigation, custom plugins. Разрабатывает кастомные компоненты (interactive API explorer, live code playground). Оптимизирует build performance и SEO.

Lead / Staff 1 требований

Technical Writer
Обязателен

Определяет docs-as-code стратегию и стандарты для организации. Выбирает toolchain, определяет architecture docs platform. Координирует миграцию с legacy wiki (Confluence) на docs-as-code подход. Обучает команды работе с инструментами.

Principal 1 требований

Technical Writer
Обязателен

Формирует долгосрочную стратегию documentation platform: выбор технологий, roadmap development, integration с developer ecosystem. Определяет инвестиции в documentation infrastructure и custom tooling.

Загрузка комментариев...