| Технический писатель | Пользователь, администратор, интегратор, поддержка, внутренняя команда. | Собирает факты, проверяет сценарий, пишет и обновляет документацию. | Инструкция, user guide, API documentation, база знаний, release notes, troubleshooting. | Это базовая роль страницы: отвечает за документ, по которому читатель выполняет действие. |
| Технический редактор | Автор документа, документационная команда, продуктовая или инженерная команда. | Проверяет точность, структуру, стиль, термины, стандарты, ссылки и единообразие. | Отредактированный и согласованный документ, style guide, чек-лист качества. | Чаще редактирует и проверяет материал, а не создаёт весь документ с нуля. |
| API technical writer | Разработчик, интегратор, партнёрская команда. | Описывает endpoint, method, параметры, auth, request, response, status codes и ошибки. | API reference, OpenAPI-описание, примеры запросов, SDK snippets. | Это специализация технического писателя с упором на API и интеграции. |
| UX writer | Пользователь внутри интерфейса. | Пишет microcopy: кнопки, подсказки, ошибки, пустые состояния, onboarding. | Короткие интерфейсные тексты и правила тона продукта. | Работает внутри интерфейса, а не с длинной документацией и базой знаний. |
| Content Designer | Пользователь продукта или сервиса. | Проектирует содержание сценария вместе с UX, продуктом и исследованием. | Контент-модель, структура экранов, тексты, пользовательский путь. | Фокус шире текста документа: содержание становится частью продуктового дизайна. |
| Knowledge Manager | Сотрудники, поддержка, внедрение, внутренние пользователи. | Строит систему знаний, владельцев разделов, поиск, архив и актуализацию. | База знаний, правила публикации, метрики использования, процесс обновления. | Меньше пишет отдельные документы, больше управляет knowledge system. |
| Бизнес-аналитик | Заказчик, команда разработки, владелец продукта. | Собирает требования, описывает процесс, ограничения и критерии приёмки. | Требования, user stories, модели процессов, acceptance criteria. | Описывает, что нужно сделать в системе; техпис объясняет, как системой пользоваться. |
| Системный аналитик | Разработка, интеграции, тестирование. | Описывает поведение системы, API, данные, статусы, ошибки и интеграции. | Спецификация, модель данных, описание API, схема интеграции. | Готовит техническое описание для реализации, а не пользовательскую документацию. |
| Специалист поддержки | Пользователь с конкретной проблемой. | Разбирает обращение, диагностирует ситуацию, даёт решение или эскалирует. | Ответ пользователю, тикет, workaround, сигнал для базы знаний. | Решает один случай; техпис превращает повторяющийся случай в документ. |
| Developer advocate | Внешние разработчики, партнёры, сообщество. | Объясняет продукт разработчикам, делает примеры, собирает обратную связь, выступает. | Tutorials, demo apps, guides, talks, sample code, developer portal. | Документация является частью работы, но фокус шире: adoption и developer relations. |