私はインドで何人かの開発者と仕事をしていますが、私たちの最大の問題の 1 つは変数の命名です。最初、私は非常にイライラし、なぜ彼らが物事に適切な名前を付けないのか理解できませんでした (それは怠惰でしたか?)。英語、そして彼らが読む英単語は、彼らにとってほとんどまたはまったく意味がありません. 今では当たり前のように思えますが、英語が十分に理解できないと、変数にうまく名前を付けることができません。
外国語を話すチームメンバーと一緒に、より良いネーミングプラクティスに取り組むにはどうすればよいですか?
これが少し主観的である場合は申し訳ありませんが、コミュニティ wiki としてマークしました。
ありがとう！
チームのメンバーの要件を変更します。メンバーは、書かれた英語を十分に理解している必要があります。
編集：ビルKのコメントに応えて、貧弱なコミュニケーションの問題に対処するためのコストは節約の計算に考慮されていないように私には思えます。いいえ、私は海外の開発者と仕事をしたことはありませんが、英語を母国語としない2人のスピーカーと仕事をしているので、彼らは両方とも米国に20年間住んでいますが、コミュニケーションが少し遅くなることがあります。
また、自分の答えが最も役立つとは思っていませんでした。ただ主張しようとしています。あなたがあなたのオフィスで働くために誰かを雇わないのなら、なぜあなたは地球の反対側からあなたのために働くために彼らを雇うのですか？代理店を経由している場合でも、コードに取り組んでいるすべての開発者を間接的に採用しています。
私の経験では、開発の才能に関しては、安いことはかなりの費用がかかる可能性があります。
「変数の命名」を各コードレビューのトピックにすることができます。議論しやすいのは、事実上の議事項目でしょう。あなたは彼らが達成しようとしていることを彼らが理解しているかどうかについてのゲージとして議論を使うことができます。
全員が同じ言語を話し、コードを他の会社に販売しない場合は、母国語でコードを記述してもかまいません。
各メンバーが異なる言語を話す場合、コードは英語である必要があります。アプリケーションで使用される最も一般的な単語の辞書を作成して、誰もが確認できるようにしてください。必要に応じて、より英語力のある人を選んで翻訳してください。
また、単語が間違っているように見える場合は、いつでもリファクタリングできます。
ほとんどの開発者は、技術的な英語をある程度理解している必要があります（結局のところ、ほとんどの言語のAPIは英語で書かれています）。したがって、英語は良い選択のようです。変数には通常、xCounter、isXYZなどの非常に難しい名前はありません。名前を付けるのが難しい場合は、その変数が宣言されている抽象化のレベルがそうではないことを確実に示します。正しいもの。
変数名をローカライズすることを提案するかもしれません。他の大陸にいる人や海外で買収した会社などがコードを取得するのが一般的である今日では、非常に難しいことがわかりました。
何かを与えなければならない☺</p>
批判するつもりはありませんが、本当の質問があります...彼らが変数に名前を付けるのに十分なほど英語に堪能でない場合、英語ベースのビジネスドメインモデルを理解するのに十分なほど流暢に話せますか?その分野で現実世界の問題を解決するソフトウェア製品を構築しますか?
あなたが一緒に働いている、英語を知っている開発者を見つけて、彼ら全員に彼によって変数名を実行させますか？
たぶん、彼らに母国語で説明的に変数に名前を付けてから、翻訳者を使ってそれらを英語に変換してもらうのでしょうか？マークアップを追加し、プリコンパイラを実行して自動翻訳を行うことさえできるでしょうか？ちょっとした考え。
特定の問題、つまり変数名が説明的でない、または変数名を使用している、英語ではない、変数の命名スタイルが一貫していないなどについてはわかりません。いずれにせよ、詳細なコーディング標準を確立し、おそらくコード監査を使用することができますまたはそれらを実施するためのレビュー。例えば：
重要なのは、これらのルールを公開し、組織全体に適用することです。