Ciao a tutti,
Quando si ospita Discourse in autonomia, la maggior parte degli amministratori modifica containers/app.yml (modello standalone) e i file YAML correlati. I campioni predefiniti sono ben commentati, ma solo in inglese. Per gli amministratori non anglofoni, questa diventa una fonte comune di errori, specialmente perché YAML è sensibile agli spazi bianchi e molte opzioni sono sottili.
Recentemente ho creato una versione completamente commentata in cinese per la mia distribuzione e ho notato che esiste già uno snippet in cinese nella documentazione tradotta, il che è stato davvero utile. Discourse Meta
Questo mi ha fatto pensare: invece di fare affidamento su soluzioni isolate della comunità per ogni lingua, potremmo fornire modelli ufficiali con commenti multilingue?
Proposta:
-
Aggiungere un flusso di lavoro (o script) assistito dall’IA che prenda il
samples/standalone.yml/containers/app.ymlpredefinito e generi traduzioni dei commenti. -
Pubblicare una piccola serie di varianti ufficialmente supportate (ad esempio, en, zh_CN, zh_TW, ja, ko, es, fr, de).
-
Mantenere chiavi/valori YAML identici; tradurre solo i commenti.
-
Renderlo disponibile nella guida all’installazione o in
discourse-setupcome output opzionale.
Perché questo aiuta:
-
Abbassa la barriera per i nuovi host autonomi in tutto il mondo.
-
Riduce la cattiva configurazione causata dalla mancata comprensione dei commenti.
-
Rende più facili da imparare le “impostazioni predefinite sicure” senza dover cercare nella documentazione.
-
Facile da mantenere: le traduzioni possono essere rigenerate quando i modelli cambiano.
Se l’idea piace, sono felice di condividere la mia versione commentata in cinese come punto di partenza, o di aiutare a testare una pipeline automatizzata.
Cosa ne pensate? Sarebbe utile includerlo nell’esperienza di installazione ufficiale?
