Определяет организационные стандарты REST API design и документирования. Координирует API governance: design reviews, breaking change detection, deprecation policy. Обеспечивает consistency API design через документированные standards.
Роли · Technical Writer · Lead
Что должен уметь Lead }
10 ключевых навыков, всего 45. Ожидания по каждому навыку и что меняется на следующем уровне.
На этой странице — что ожидается от Lead }, навык за навыком. Ключевые навыки оценивают руководитель и коллеги в цикле ревью; остальные учитываются только в самооценке. Основные области: API и интеграции, Контроль версий и коллаборация, Документация.
Ключевые навыки для Lead
Сгруппированы по областям. Метка справа — ожидаемая глубина: Осведомлённость, Применение, Продвинутый или Эксперт.
API и интеграции · 1
Контроль версий и коллаборация · 1
Определяет организационный стандарт docs-as-code: workflows, branching strategy для docs, review процессы, quality metrics. Координирует миграцию команд на docs-as-code подход. Создаёт contribution guidelines для разработчиков.
Документация · 8
Выстраивает систему контент-стратегии для API-документации на уровне продукта: content types, audience mapping, content lifecycle. Координирует работу писателей и разработчиков. Внедряет user feedback loop для непрерывного улучшения документации.
Определяет стандарты архитектурной документации для организации: обязательные артефакты, уровни детализации, процесс review. Координирует архитектурную документацию между командами, обеспечивая единую картину системного ландшафта.
Определяет организационные стандарты визуализации технической информации: нотации, инструменты, color schemes, шаблоны. Координирует создание unified system landscape diagrams, объединяющих знания разных команд. Обучает технике визуализации.
Определяет docs-as-code стратегию и стандарты для организации. Выбирает toolchain, определяет architecture docs platform. Координирует миграцию с legacy wiki (Confluence) на docs-as-code подход. Обучает команды работе с инструментами.
Определяет knowledge management стратегию для организации. Выбирает инструментарий, стандартизирует процессы, обучает авторов. Обеспечивает знания не теряются при ротации сотрудников через structured knowledge capture.
Определяет стандарты runbook-ов для всей организации. Внедряет culture of operational documentation. Координирует runbook coverage: каждый production service имеет полный набор runbook-ов. Проводит runbook reviews.
Определяет content strategy для технического контента организации. Координирует авторов из разных команд. Внедряет editorial process: ideation, writing, review, publication, distribution. Измеряет impact контента.
Определяет стандарты пользовательской документации для организации. Координирует локализацию на несколько языков. Формирует метрики quality и effectiveness. Выстраивает feedback loop с product и support командами.
Дополнительные навыки
Команда их не оценивает, но они входят в самооценку и план развития.
Что меняется на Principal
0 навыков получают более высокое ожидание или становятся ключевыми при переходе с Lead на Principal. Сначала самые большие скачки.
} в открытой матрице компетенций: 45 навыков на 5 уровнях. Матрица бесплатна для специалистов и останется бесплатной.