Con l’approccio su cui sto lavorando ora, sarebbe tecnicamente possibile consentire la generazione di commenti di Discourse direttamente sulle pagine MkDocs, ma richiederebbe l’uso di un framework lato server (Remix, Rails, ecc.) per servire le pagine MkDocs. Ciò renderebbe possibile autenticare gli utenti (con DiscourseConnect) sul sito di documentazione e consentirebbe anche l’uso di un database in memoria per memorizzare nella cache i commenti restituiti in precedenza.
(Modifica: giusto per essere chiari, sto parlando di usare Discourse come provider di identità per il sito web, non il sito web come provider di identità per Discourse. Quest’ultimo approccio funziona, ma è troppo inflessibile per la maggior parte dei casi d’uso.)
Sarebbe comunque un grande cambiamento da chiedere al tuo team.
Sono sicuro che dalla tua prospettiva sarebbe più semplice se ciò fosse realizzato interamente all’interno di Discourse, ma è anche possibile utilizzare Discourse come sistema di gestione dei contenuti. In tal caso, la documentazione markdown verrebbe generata come normali topic di Discourse. I webhook di Discourse verrebbero utilizzati per attivare la generazione di una pagina di documentazione su un sito esterno. Questa è in realtà la base del sito demo dei commenti di Discourse che sto configurando.