Как подружить диплодока со сфинксом: документируем Python SDK

Как расширять сложную платформу новыми типами документации при ограниченных ресурсах? Как быть, если часть большого продукта требует документации на базе другого фреймворка? И можно ли подружить, на первый взгляд, несовместимые технологии и не сломать существующие процессы? 

В докладе я расскажу о том, как мы в Yandex Cloud учились документировать Python SDK, какие инструменты использовали для этого и с какими сложностями столкнулись в процессе.