Con el enfoque en el que estoy trabajando ahora, sería técnicamente posible permitir que los comentarios de Discourse se generen directamente en las páginas de MkDocs, pero requeriría el uso de un framework del lado del servidor (Remix, Rails, etc.) para servir las páginas de MkDocs. Eso haría posible autenticar a los usuarios (con DiscourseConnect) en el sitio de documentación y también permitiría usar una base de datos en memoria para almacenar en caché los comentarios devueltos anteriormente.
(Edición: solo para aclarar, estoy hablando de usar Discourse como proveedor de identidad para el sitio web, no el sitio web como proveedor de identidad para Discourse. Este último enfoque funciona, pero es demasiado inflexible para la mayoría de los casos de uso).
Sin embargo, sería un gran cambio pedirle a su equipo que lo haga.
Estoy seguro de que desde su perspectiva sería más sencillo si esto se lograra completamente dentro de Discourse, pero también es posible usar Discourse como un sistema de gestión de contenido. En ese caso, la documentación de markdown se generaría como temas regulares de Discourse. Se usarían webhooks de Discourse para activar la generación de una página de documentación en un sitio externo. Esa es, de hecho, la base del sitio de demostración de comentarios de Discourse que estoy configurando.