Ведущий технический писатель (документация и стандарты открытых API)

Банк России совместно с Ассоциацией ФинТех и ключевыми участниками финансового рынка занимается созданием среды Открытого банкинга. На площадке АФТ прорабатываются предложения по изменению регулирования, модернизации технологической инфраструктуры.

В связи с расширением команды направления у нас открывается новая вакансия Ведущего технического писателя (документация и стандарты открытых API), приглашаем стать частью самого инновационного и масштабного финтех проекта!

Для нас данная роль это не только разработка документации, а еще и интересные задачи по методологии, обзору трендов и самостоятельному формированию правил для финтех отрасли.

Успешный кандидат будет отвечать за качество и единообразие API-документации и стандартов и развитие методологии документирования.

Мы ищем специалиста, обладающего системным мышлением и готовностью погрузиться в технические инструменты (Git, CI/CD, сложные репозитории, работа с Markdown, HTML), необходимо иметь хорошее понимание API и уметь создавать техническую документацию.

Основной функционал новой роли:

• Поддержание и развитие документации по OpenAPI на обзорном, функциональном, техническом, бизнес, прикладном уровнях.

• Контроль качества спецификаций и технических стандартов: структура, орфография, единообразие, консистентность.

• Подготовка финальных версий документов (PDF, Word, HTML, Markdown), ведение версий и контроль изменений.

• Ведение и проверка чек-листов и артефактов в рамках релиз-менеджмента документации.

• Свод правок, обработка замечаний, работа с таблицами соответствий и реестрами компонентов.

• Поддержка инструментов документации: шаблоны, профили спецификаций, гайды, best practices, справочники, реестры компонентов.

• Формирование и поддержание структуры Базы знаний: статьи, FAQ, обучающие материалы.

• Разработка и ведение внутренних регламентов, методологии и стандартов документирования API.

• Аудит текущей структуры стандартов и документации, поддержка единого стиля.

• Работа с Git и репозиториями для актуализации и публикации документации.
  
  Требуемые навыки:

• Владение Markdown, базовым HTML, понимание синтаксиса YAML, уверенная работа с PDF/Word.

• Опыт работы с Git, репозиториями, коммитами и версионированием документов.

• Опыт подготовки, проверки и актуализации технической документации.

• Умение структурировать информацию, вести таблицы и реестры.

• Знание OpenAPI/AsyncAPI, базовое понимание API-дизайна и процессов интеграции.

• Внимательность к деталям, грамотная речь, системное мышление.

• Навыки работы в команде: согласование правок, участие в обсуждениях, взаимодействие с разными ролями.

• Желателен опыт работы с CI/CD-процессами публикации документации, инструментами визуализации (диаграммы взаимодействия).

Какие нужны soft skills:

• ​​​​​​Внимательность и аккуратность.
• Системное мышление и структурность, умение упорядочивать большие объёмы информации.
• Коммуникабельность, готовность обсуждать правки и находить общий язык с разными ролями (БА, ПМ, СА, руководитель).
• Навыки фасилитации (умение собирать и консолидировать комментарии от разных участников).
• Гибкость и адаптивность.
• Ориентация на качество и интерес к продукту - стремление делать документацию удобной и понятной для конечных пользователей.
• Самостоятельность, исключительная внимательность к деталям и умение приводить хаос в порядок.