Olá a todos,
Ao auto-hospedar o Discourse, a maioria dos administradores edita containers/app.yml (template standalone) e arquivos YAML relacionados. As amostras padrão são bem comentadas, mas apenas em inglês. Para administradores que não falam inglês, isso se torna uma fonte comum de erros — especialmente porque YAML é sensível a espaços em branco e muitas opções são sutis.
Recentemente, criei uma versão totalmente comentada em chinês para minha própria implantação e notei que já existe um trecho em chinês na documentação traduzida, o que foi muito útil. Discourse Meta
Isso me fez pensar: em vez de depender de soluções pontuais da comunidade para cada idioma, poderíamos fornecer modelos oficiais com comentários multilíngues?
Proposta:
-
Adicionar um fluxo de trabalho (ou script) assistido por IA que pegue o
samples/standalone.yml/containers/app.ymlpadrão e gere traduções de comentários. -
Publicar um pequeno conjunto de variantes oficialmente suportadas (por exemplo, en, zh_CN, zh_TW, ja, ko, es, fr, de).
-
Manter as chaves/valores YAML idênticos; apenas traduzir os comentários.
-
Torná-lo disponível no guia de instalação ou em
discourse-setupcomo uma saída opcional.
Por que isso ajuda:
-
Reduz a barreira para novos auto-hospedeiros em todo o mundo.
-
Diminui a má configuração causada pela má interpretação dos comentários.
-
Torna os “padrões seguros” mais fáceis de aprender sem ter que procurar na documentação.
-
Fácil de manter: as traduções podem ser regeneradas quando os modelos mudam.
Se as pessoas gostarem da ideia, ficarei feliz em compartilhar minha versão comentada em chinês como ponto de partida ou ajudar a testar um pipeline automatizado.
O que vocês acham? Seria útil incluir isso na experiência de instalação oficial?
