推奨事項

Lunaria は、オープンソースコミュニティが複雑なローカライズプロジェクトに取り組むのを支援することを目的として開発されました。しかし、ツールだけでは、その道の半分しか進んでいません。

このページでは、あなたのプロジェクトの日常業務を改善し、Lunaria をより効果的に活用するとともに、コントリビューターおよびメンテナーの生活をより良くするために、私たちが推奨する事項をリストアップしています。

まとめてマージするマージコミットを使用する

Lunaria の Git ベースのトラッキングシステムは、デフォルトですべてのコミットを考慮します。主ブランチに複数のコミットがマージされた場合、それぞれのコミットとその変更されたファイルは、タイトルや他のメタデータに基づいて異なるステータスになる可能性があります。

このため、まとめてマージするマージコミット を使用することで、各プルリクエストごとにステータスの変更が行われるようにし、コミットごとの変更ではなく、プルリクエスト単位での一貫性を持たせることができます。

プルリクエストを小さく保つ

継続的な変更が頻繁に加わる高活動プロジェクトでは、元のコンテンツが変更された際に、まだレビュー中のプルリクエストにその内容が含まれていないかどうかを追跡・確認するのが難しくなることがあります。

1つのプルリクエストで小さな変更を行うことで、何が見落とされているかをトレースしやすくなるだけでなく、レビュアーにとっても参加しやすく、ローカライズされたコンテンツの品質を確保しやすくなります。

コミュニティに指示を出す

いくつかの可能性のあるコントリビューターは、Lunaria に慣れていない、あるいはオープンソースプロジェクトへの貢献に慣れていない、あるいは両方とも初めてかもしれません。そのため、プロセス全体を文書化することが極めて重要です。これにより、新規コントリビューターが混乱したり、メンテナーや貢献者をうまく導くのが難しくならないようにします。

Astro Docs の国際化ガイド は、参考にする良い例です。全体として、ローカライズに関するドキュメントには、以下の項目を多く含めるべきです：

• 初心者向けの要件とは？（ツール、事前の経験など）
• ローカライズの構造は？（コンテンツはどこにあるのか、どうやって X や Y をローカライズするのかなど）
• コントリビューターはどのように貢献できるか？（どの部分の支援が最も必要か、何を貢献できるかを見つける方法など）