変更履歴

ツールが初めて真のレポジトリに出会う時、多くのことを学べます。私たちにとってはそれは Tuist でした。彼らのチームは毎日 main にマージを何回もおこない、Glossia は私たちが構築した通り、すべての変更を翻訳し、準備ができ次第すぐに各ファイルをプッシュしました。結果は、ほぼすべてのマージごとに新しいプルリクエストとなり、それぞれが約 150 のコミットを持ち、誰も要求しなかったチェックで満たされた CI キューとなりました。彼らのドキュメントページの一部も、コンポーネントやアラートがプレーンテキストとしてエスケープされた形で返ってきました。私たちがずっと語る静かで、背景での体験ではありません。

それは辛かったです。なぜなら、私たちは常に最も良い翻訳システムとは、考える必要のないものだと述べているからです。あなたの CI を塞ぎ、またはあなたのドキュメントを壊すプルリクエストはその反対です。そこで私たちは戻り、翻訳があなたのレポジトリに達する方法を再考しました。

Glossia は今、プロジェクトごとに単一のプルリクエストを維持し、コンテンツが変わるに従ってそれを成長させます。それはすでにそのブランチにあるロックファイルを読み取り、そのため新しいものだけを翻訳し、ファイル別ではなくバッチでプッシュします。Tuist のようなレポジトリの場合、かつて 150 回あったプッシュが、数回のプッシュに過ぎません。

私たちもまた、触るべきでないあなたのドキュメントの一部を触るのをやめました。Glossia は以前、翻訳されたすべてのページを再構築しており、完全に理解できなかったもの、例えば Phoenix コンポーネントや GitHub アラートなどは、エスケープされたまま渡ってきました。今では、翻訳された文だけを差し替え、残るすべてはあなたが書いたままにします。予想しなかった良い副次効果がありました：モデルは現在全文とページの残りを認識するため、翻訳はより良く読めます。日本語の場合、リンクはもはや英語文内で不自然に置かれる必要はなくなりました。

最後に、プルリクエストは起きたことを告诉你します。翻訳された言語やファイルは？どのコミットからなのか？スコアは？用語集のどの用語が形作ったのか？そして、何があなたの注意を要するか。私たちはそれを、レビューを依頼する前に慎重な同僚があなたに残すメモのように考えます。

Tuist チームがその間示してくれた忍耐を感謝します。もし Glossia がこのようにあなたの邪魔になることがあれば、ぜひ教えてください。