Роли · Technical Writer · Senior
10 ключевых навыков, всего 45. Ожидания по каждому навыку и что меняется на следующем уровне.
На этой странице — что ожидается от Senior }, навык за навыком. Ключевые навыки оценивают руководитель и коллеги в цикле ревью; остальные учитываются только в самооценке. Основные области: API и интеграции, Контроль версий и коллаборация, Документация.
Сгруппированы по областям. Метка справа — ожидаемая глубина: Осведомлённость, Применение, Продвинутый или Эксперт.
Проектирует документационную стратегию для REST API: API style guide, linting rules (Spectral), design-first workflow. Документирует сложные паттерны: HATEOAS, conditional requests, batch operations, webhooks. Обеспечивает API governance через docs.
Проектирует масштабируемые docs-as-code процессы: multi-repo documentation, cross-references, automated content generation. Внедряет content reuse (snippets, includes, variables). Создаёт custom CI checks для quality gates документации.
Создаёт продвинутый контент для API-документации: migration guides между версиями, architecture overviews, best practices. Разрабатывает style guide для API-описаний. Проводит UX-ревью документации с позиции developer experience.
Проектирует структуру и процесс ведения архитектурной документации для крупных систем. Внедряет diagrams-as-code подход (Mermaid, PlantUML, Structurizr DSL). Обеспечивает связность между ADR, архитектурными диаграммами и API-документацией.
Проектирует visual language и стандарты диаграммирования для проекта. Внедряет diagrams-as-code подход: Mermaid/PlantUML в Git, автогенерация из кода, CI-валидация. Создаёт интерактивные диаграммы для developer portal (clickable architecture maps).
Проектирует docs-as-code инфраструктуру для крупных проектов: monorepo docs, cross-project navigation, custom plugins. Разрабатывает кастомные компоненты (interactive API explorer, live code playground). Оптимизирует build performance и SEO.
Создаёт масштабируемую knowledge management систему: cross-team search, content federation, automated content lifecycle. Интегрирует knowledge base с developer portal, runbooks, API docs. Определяет метрики качества и usage analytics.
Проектирует систему runbook-ов для организации: taxonomy, lifecycle, integration с alerting и incident management. Создаёт automated runbooks (runbook automation через scripts/playbooks). Обеспечивает runbook-и тестируются регулярно.
Выстраивает engineering blog как канал developer relations: thought leadership, open source contributions, hiring brand. Создаёт сложный контент: architecture deep-dives, postmortem analyses, technical strategy articles. Менторит авторов.
Проектирует user documentation strategy: content model, localization, accessibility, multi-product navigation. Создаёт interactive documentation: embedded walkthroughs, contextual help, in-app tooltips. Внедряет analytics для измерения effectiveness.
Команда их не оценивает, но они входят в самооценку и план развития.
45 навыков получают более высокое ожидание или становятся ключевыми при переходе с Senior на Lead. Сначала самые большие скачки.
} в открытой матрице компетенций: 45 навыков на 5 уровнях. Матрица бесплатна для специалистов и останется бесплатной.