улица Арбат 10
Банк России совместно с Ассоциацией ФинТех и ключевыми участниками финансового рынка занимается созданием среды Открытого банкинга. На площадке АФТ прорабатываются предложения по изменению регулирования, модернизации технологической инфраструктуры.
В связи с расширением команды направления у нас открывается новая вакансия Ведущего технического писателя (документация и стандарты открытых 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:
- Внимательность и аккуратность.
- Системное мышление и структурность, умение упорядочивать большие объёмы информации.
- Коммуникабельность, готовность обсуждать правки и находить общий язык с разными ролями (БА, ПМ, СА, руководитель).
- Навыки фасилитации (умение собирать и консолидировать комментарии от разных участников).
- Гибкость и адаптивность.
- Ориентация на качество и интерес к продукту - стремление делать документацию удобной и понятной для конечных пользователей.
- Самостоятельность, исключительная внимательность к деталям и умение приводить хаос в порядок.
