仕事でソースコードのコメントを英語で書くべきか - あなたとあなたの話がしたい

今年の1月から新規立ち上げの開発部署でチームリーダーをやっていて、色々と「俺の考えた最強の開発手法」的なものを試しているのだけれど、その一環で、日本語でなく英語でコミットメッセージやソースコードのコメントを書くという開発ルールを導入してみた。 その結果、メリットよりもデメリットが大きいことが判明して、チームとして英語で書くのをやめにしたので、その振り返りを書きたい。 英語でコメントを書くメリット Web開発の世界でグローバルな共通語として機能している 日本語入力に切り替える必要がないので、タイピング効率が良い 文法的に日本語よりもロジカルに書きやすい GitHub CopilotやChatGPTのような生成AIのツールとの相性が良い RuboCopのRSpec/ContextWordingのように、英語利用を前提としたルールを提供しているLinterがある 当初このような点をメリットとして

[fuyu77]

2023/09/19追記。ブコメを受けて、見解の修正と経緯の補足について記事下部に追記しました。

[dagama]

最初に英語ルールにしたとき、みんな苦手意識があるのにネガティブ意見が出なかったのは既にチーム作りに失敗してるからだぞ。お前の意見に誰も反対できない空気があるんだろ。

[xlc]

業務上英語が必要なら公用語を英語にすればよろしい。趣味で現場をかき乱すはやめよう。

[heppokopg2013]

変数やメソッド名も日本語解禁するといいぞ

[juejue]

“私の場合、それでも英語を書きたい” こいつやばすぎる。チームが回る事より自分を優先する奴と仕事したくねーわ。楽天にでも行け。

[door-s-dev]

当初の想定でこのデメリットが想像できなかったんだろうか。自分がどうしたいかだけでチームの事が見えてないような

[strawberryhunter]

日本人しかいないならメリット皆無。

[teruspr]

日本人しか読まないコメントを英語で書かせるの意味不明だな。自分の上司がフランス語オタクで「コメントはフランス語で」と言われた時に自分がどう感じるか、胸に手を当てて考えるべき。

[kumicho24]

"Web開発という仕事は、世界の開発者と英語でつながっていることに大きな魅力があると感じるためだ。"　どういう意味なんだろ？一緒に仕事してるのは日本人だけに見えるが

[sukoyakacha]

母国語でいい。英語で世界と繋がりたいなら、そういう職を選べばいい。どうせ日本人しか触らないクローズドなソースでやる意味は、、、

[quabbin]

コメントに何を書いているか気になる。私はぼやきを書くようにする。ブロックごとの意味は関数に分けろ。コメントは「やりたくても(成約や技術的に)できない事」を原因とともにボヤく場だ。母語以外では、できまい？

[s_rsak]

チームメンバーはこっそりGoogle翻訳をつかってそう。

[dtpg]

勘違いしたポンコツはタチが悪い。

[odakaho]

始めてから気づくのヤバいw “始めてみると、そもそもの話として、英語を読んだり書いたりすることが好きなのがチーム内に私しかいない”

[byourself]

日本語の方が短い文字で情報を表せるから良いんだよね。でもCopilotとかの相性は英語の方が良い。そもそも関数名とか全部英語だし、AIがドライバになってそのうちコメントも英語が徐々に浸透していくのでは。

[kkobayashi]

純粋な技術のことなら英語でいいけど業務に関するコメントは英語だと分かりにくいのでは？

[nil0303]

英語をしっかり書けない=書いてある英語を翻訳する作業が絶対発生しているので、何なら効率マイナスまであるでしょ。「私の場合、それでも英語を書きたいので」とか色々察してしまう。

[ysksy]

提案した時点で馬鹿じゃないんです？とかここ笑うところ？とか言ってくれないチームな時点で英語以前にヤバそう。

[btron]

海外拠点があるとか海外向けにオープンソース化するとかが無いとコメントを英語化するメリットはなさそう。それよりツールを英語で使うとトラブル対応時に有利かと。もうやってるかもしれけど。

[gm91]

文章で書こうとするからじゃね。

[red_kawa5373]

プロジェクトによる。インド人や中国人もソースを見る可能性があるなら、英語で書くか、日本語と英語を併用するか。

[aya_momo]

最初は日本語で書いて、徐々に英語に直している。

[hatest]

まずコメントで大まかなロジックの流れを日本語で書いて、その流れに従ってコメントの下にコードを書いていくなぁ。なので、コード書いてるときに日本語には切り替えてないが、コメントは日本語になってる

[petronius7]

そりゃコメントを書くのも読むのも人間なんだから、互いに伝えられる情報量が多い物を選べばいい。日本語の場合「誰が」「何を」「どうする」をはっきり書くように心がけると曖昧さが減るはず。

[nhayato]

米国で働いてる日本人に「コメントやコミットメッセージを日本語で書く」と話すと驚かれた記憶があることを思い出した

[isrc]

主語、動詞、目的語の並びが間違っているなどの初歩的な文法ミスが高頻度で出現し、コードレビューが英作文教室のようになってしまった。コメントの量と質にも英語による悪影響があった。