Выберите текущую позицию

Укажите роль и уровень — система покажет путь развития, навыки и gap-анализ.

Путь развития

Junior

0-2 года

Текущий

Ответственность: Выполнение задач под руководством старших коллег. Изучение кодовой базы, стандартов и процессов команды. Написание кода по спецификациям, исправление простых багов, написание тестов.

Ключевые навыки:

API Documentation Writing Нужно
Architecture Documentation Нужно
Diagramming Нужно
Docs-as-Code Нужно
Knowledge Base Management Нужно
REST API Design Нужно
Runbook и Playbook Writing Нужно
Technical Blogging Нужно
User Documentation Нужно
Документация как код Нужно

Middle

2-5 лет

Следующий

Ответственность: Самостоятельная разработка фич от декомпозиции до деплоя. Участие в code review. Оптимизация производительности. Менторинг junior-разработчиков. Участие в архитектурных обсуждениях.

Ключевые навыки:

API Documentation Writing Нужно
Architecture Documentation Нужно
Diagramming Нужно
Docs-as-Code Нужно
Knowledge Base Management Нужно
REST API Design Нужно
Runbook и Playbook Writing Нужно
Technical Blogging Нужно
User Documentation Нужно
Документация как код Нужно
Переход: ~2-3 года
  • Самостоятельно реализовал 3+ проекта
  • Провёл успешные код-ревью
  • Участвовал в разрешении production инцидентов

Senior

5-8 лет

Ответственность: Проектирование архитектуры компонентов и сервисов. Решение сложных технических проблем. Ведение технического долга. Code review как gatekeeper качества. Менторинг middle-разработчиков. Выбор технологий для новых задач.

Ключевые навыки:

API Documentation Writing Нужно
Architecture Documentation Нужно
Diagramming Нужно
Docs-as-Code Нужно
Knowledge Base Management Нужно
REST API Design Нужно
Runbook и Playbook Writing Нужно
Technical Blogging Нужно
User Documentation Нужно
Документация как код Нужно
Переход: ~2-3 года
  • Самостоятельно реализовал 3+ проекта
  • Провёл успешные код-ревью
  • Участвовал в разрешении production инцидентов

Lead / Staff

7-12 лет

Ответственность: Техническое лидерство команды или направления. Проектирование системной архитектуры. Координация с другими командами. Формирование стандартов и best practices. Участие в найме. Планирование технического roadmap.

Ключевые навыки:

API Documentation Writing Нужно
Architecture Documentation Нужно
Diagramming Нужно
Docs-as-Code Нужно
Knowledge Base Management Нужно
REST API Design Нужно
Runbook и Playbook Writing Нужно
Technical Blogging Нужно
User Documentation Нужно
Документация как код Нужно
Переход: ~2-3 года
  • Самостоятельно реализовал 3+ проекта
  • Провёл успешные код-ревью
  • Участвовал в разрешении production инцидентов

Principal

10+ лет

Ответственность: Техническая стратегия на уровне компании или домена. Кросс-организационное влияние. Решение системных проблем бизнеса через технологии. Менторинг lead-инженеров. Публичное представление компании.

Ключевые навыки:

API Documentation Writing Нужно
Architecture Documentation Нужно
Diagramming Нужно
Docs-as-Code Нужно
Knowledge Base Management Нужно
REST API Design Нужно
Runbook и Playbook Writing Нужно
Technical Blogging Нужно
User Documentation Нужно
Документация как код Нужно
Переход: ~2-3 года
  • Самостоятельно реализовал 3+ проекта
  • Провёл успешные код-ревью
  • Участвовал в разрешении production инцидентов

Gap-анализ: навыки для развития

Для перехода на следующий уровень необходимо развить:

API Documentation Writing

Пишет полноценные API-гайды: quickstart, authentication flow, error handling, use cases. Создаёт code samples на нескольких языках (curl, Python, JavaScript, Go). Следит за consistency терминологии и стиля во всех разделах API docs.

Architecture Documentation

Создаёт полноценную архитектурную документацию совместно с архитекторами: system context, container diagrams, component diagrams (C4). Документирует data flows, интеграции со внешними системами, deployment topology. Поддерживает документацию в актуальном состоянии.

Diagramming

Создаёт сложные технические диаграммы: C4 model (все 4 уровня), data flow diagrams, state machines, ER-диаграммы. Использует diagrams-as-code инструменты (Mermaid, PlantUML). Следит за визуальной consistency и читаемостью диаграмм.

Docs-as-Code

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

Knowledge Base Management

Проектирует информационную архитектуру knowledge base: taxonomy, navigation, search optimization. Создаёт content governance: templates, naming conventions, review процессы. Обеспечивает актуальность контента через scheduled reviews.

REST API Design

Создаёт полноценную REST API-документацию в OpenAPI/Swagger: paths, schemas, security, examples. Документирует API design conventions: naming, pagination, filtering, error format. Настраивает Swagger UI / Redoc для интерактивной документации.

Runbook и Playbook Writing

Самостоятельно создаёт runbook-и для production-систем: deployment procedures, incident response, disaster recovery. Обеспечивает пошаговость и однозначность инструкций. Проводит dry-run тестирование runbook-ов с операционной командой.

Technical Blogging

Регулярно пишет технические посты: deep-dive статьи, comparison articles, best practices guides. Оптимизирует контент для SEO и developer audience. Работает с CMS (WordPress, Ghost, dev.to). Создаёт контент-план для engineering blog.

User Documentation

Создаёт полноценную пользовательскую документацию: information architecture, content hierarchy, cross-references. Пишет для разных аудиторий (beginners, advanced users, admins). Использует user feedback для улучшения документации.

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

Полноценно работает по docs-as-code workflow: branch → write → PR → review → merge → deploy. Настраивает CI/CD для автоматической сборки и публикации документации. Использует linting (markdownlint, vale) для контроля качества текста.