Видео не связанное напрямую с Python, но показалось мне интересным, так как я сейчас столкнулся с похожей задачей. До тех пор, пока у нас все части системы общаются по REST проектирование и документированние api - довольно простая задача. Когда в системе появляется, например, grpc - все становится сложнее. В видео расказывается о унифицированном подходе проектирования/документирования для таких случаев https://www.youtube.com/watch?v=oG6-r3UdenE&feature=youtu.be