Отличный пост про docs as code и конкретно Sphinx/reST.