アイデア:AIを使って、多言語コメント付きのapp.yml / standalone.ymlテンプレートを生成する

皆さん、こんにちは。

Discourseをセルフホストする場合、ほとんどの管理者はcontainers/app.yml(スタンドアロンテンプレート)および関連するYAMLファイルを編集します。デフォルトのサンプルにはコメントが適切に記載されていますが、それは英語のみです。非英語圏の管理者にとって、これは間違いの一般的な原因となります。特にYAMLは空白文字に敏感であり、多くのオプションが微妙であるためです。

私は最近、自身のデプロイ用に完全にコメントアウトされた中国語版を作成し、翻訳されたドキュメントにすでに中国語のスニペットがあることに気づきました。これは非常に役立ちました。Discourse Meta
これにより、コミュニティによる言語ごとの一時的な対応に頼るのではなく、公式に多言語でコメントされたテンプレートを提供できないかと考えました。

提案:

  1. AI支援のワークフロー(またはスクリプト)を追加し、デフォルトのsamples/standalone.yml / containers/app.ymlを取得してコメントの翻訳を生成します。

  2. 公式にサポートされる少数のバリアント(例:en、zh_CN、zh_TW、ja、ko、es、fr、de)を公開します。

  3. YAMLのキー/値は同一に保ち、コメントのみを翻訳します。

  4. インストールガイドまたはdiscourse-setupでオプションの出力として利用できるようにします。

これが役立つ理由:

  • 世界中の新規セルフホスターの参入障壁を下げます。

  • コメントの誤解による設定ミスを減らします。

  • ドキュメントを探し回ることなく、「安全なデフォルト」を簡単に学習できます。

  • メンテナンスが容易:テンプレートが変更されたときに翻訳を再生成できます。

もしこのアイデアが気に入っていただければ、私の中国語コメント付きバージョンをたたき台として共有したり、自動化されたパイプラインのテストにご協力したりできます。

どう思われますか?これは公式のインストール体験に含めると有用でしょうか?

image