Com a abordagem em que estou trabalhando agora, seria tecnicamente possível permitir que comentários do Discourse fossem gerados diretamente nas páginas do MkDocs, mas isso exigiria o uso de um framework do lado do servidor (Remix, Rails, etc.) para servir as páginas do MkDocs. Isso tornaria possível autenticar usuários (com DiscourseConnect) no site de documentação e também permitiria o uso de um banco de dados em memória para cache de comentários retornados anteriormente.
(Edição: apenas para deixar claro, estou falando de usar o Discourse como um provedor de identidade para o site, não o site como provedor de identidade para o Discourse. A última abordagem funciona, mas é muito inflexível para a maioria dos casos de uso.)
Essa seria uma grande mudança para pedir à sua equipe.
Tenho certeza de que, da sua perspectiva, seria mais simples se isso fosse realizado inteiramente dentro do Discourse, mas também é possível usar o Discourse como um sistema de gerenciamento de conteúdo. Nesse caso, a documentação em markdown seria gerada como tópicos regulares do Discourse. Webhooks do Discourse seriam usados para acionar a geração de uma página de documentação em um site externo. Essa é, na verdade, a base do site de demonstração de comentários do Discourse que estou configurando.