Avec l’approche sur laquelle je travaille actuellement, il serait techniquement possible de générer des commentaires Discourse directement sur les pages MkDocs, mais cela nécessiterait l’utilisation d’un framework côté serveur (Remix, Rails, etc.) pour servir les pages MkDocs. Cela permettrait d’authentifier les utilisateurs (avec DiscourseConnect) sur le site de documentation et également d’utiliser une base de données en mémoire pour la mise en cache des commentaires précédemment renvoyés.
(Edit : pour être clair, je parle de l’utilisation de Discourse comme fournisseur d’identité pour le site Web, et non du site Web comme fournisseur d’identité pour Discourse. Cette dernière approche fonctionne, mais elle est trop inflexible pour la plupart des cas d’utilisation.)
Ce serait cependant un changement majeur à demander à votre équipe.
Je suis sûr que de votre point de vue, ce serait plus simple si cela était accompli entièrement à l’intérieur de Discourse, mais il est également possible d’utiliser Discourse comme système de gestion de contenu. Dans ce cas, la documentation markdown serait générée sous forme de sujets Discourse classiques. Les webhooks Discourse seraient utilisés pour déclencher la génération d’une page de documentation sur un site externe. C’est d’ailleurs la base du site de démonstration des commentaires Discourse que je mets en place.