Hola a todos:
Cuando se autoalojan instancias de Discourse, la mayoría de los administradores editan containers/app.yml (plantilla independiente) y archivos YAML relacionados. Las muestras predeterminadas están bien comentadas, pero solo en inglés. Para los administradores que no hablan inglés, esto se convierte en una fuente común de errores, especialmente porque YAML es sensible a los espacios en blanco y muchas opciones son sutiles.
Recientemente, hice una versión totalmente comentada en chino para mi propio despliegue y noté que ya había un fragmento en chino en la documentación traducida, lo cual fue muy útil. Discourse Meta
Eso me hizo pensar: en lugar de depender de soluciones puntuales de la comunidad por idioma, ¿podríamos proporcionar plantillas oficiales con comentarios multilingües?
Propuesta:
-
Agregar un flujo de trabajo (o script) asistido por IA que tome el
samples/standalone.yml/containers/app.ymlpredeterminado y genere traducciones de comentarios. -
Publicar un pequeño conjunto de variantes oficialmente compatibles (por ejemplo, en, zh_CN, zh_TW, ja, ko, es, fr, de).
-
Mantener las claves/valores de YAML idénticos; solo traducir los comentarios.
-
Ponerlo a disposición en la guía de instalación o en
discourse-setupcomo una salida opcional.
Por qué esto ayuda:
-
Reduce la barrera de entrada para los nuevos autoalojadores en todo el mundo.
-
Reduce la mala configuración causada por la incomprensión de los comentarios.
-
Facilita el aprendizaje de las “configuraciones predeterminadas seguras” sin tener que buscar en la documentación.
-
Fácil de mantener: las traducciones se pueden regenerar cuando cambian las plantillas.
Si a la gente le gusta la idea, estaré encantado de compartir mi versión comentada en chino como punto de partida, o ayudar a probar una canalización automatizada.
¿Qué piensan? ¿Sería útil incluir esto en la experiencia de instalación oficial?
