С подходом, над которым я сейчас работаю, технически возможно разрешить генерацию комментариев Discourse прямо на страницах MkDocs, но для этого потребуется использовать серверный фреймворк (Remix, Rails и т. д.) для обслуживания страниц MkDocs. Это позволило бы аутентифицировать пользователей (с помощью DiscourseConnect) на сайте документации, а также использовать базу данных в оперативной памяти для кэширования ранее возвращённых комментариев.
(Редактирование: просто для ясности, я говорю об использовании Discourse в качестве провайдера идентификации для веб-сайта, а не веб-сайта в качестве провайдера идентификации для Discourse. Последний подход работает, но он слишком негибкий для большинства случаев использования.)
Однако это было бы значительным изменением, которое потребовалось бы предложить вашей команде.
Уверен, что с вашей точки зрения было бы проще, если бы это было реализовано полностью внутри Discourse, но также возможно использовать Discourse как систему управления контентом. В этом случае документация в формате Markdown будет генерироваться как обычные темы Discourse. Веб-хуки Discourse будут использоваться для запуска генерации страницы документации на внешнем сайте. На самом деле это основа демонстрационного сайта комментариев Discourse, который я настраиваю.