アカウント名:
パスワード:
最悪ってほどでもないけど、
某ガラケー関係の仕事をしていた時のこと。「PDAの某社を買収した。これからはグローバルでは外国人の方が多いからコメントは英語で書くべき。」というのは理解できなくもない。
でも実際にはその会社のプログラマで英語ができる人は圧倒的に少数派。しかも常にオーバーワーク気味で、日本語コメントを書く余力さえもほとんどない。その結果、コメントが激減して、作った本人にも理解不可能なコードが大量生産されるのは、火を見るより明らかだった。
プログラマが
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
私は悩みをリストアップし始めたが、そのあまりの長さにいやけがさし、何も考えないことにした。-- Robert C. Pike
コメントは英語で書け (スコア:2, 参考になる)
最悪ってほどでもないけど、
某ガラケー関係の仕事をしていた時のこと。
「PDAの某社を買収した。これからはグローバルでは外国人の方が多いからコメントは英語で書くべき。」
というのは理解できなくもない。
でも実際にはその会社のプログラマで英語ができる人は圧倒的に少数派。
しかも常にオーバーワーク気味で、日本語コメントを書く余力さえもほとんどない。
その結果、コメントが激減して、作った本人にも理解不可能なコードが大量生産
されるのは、火を見るより明らかだった。
プログラマが
Re: (スコア:0)
コメントだから、いい加減な英語でも意味が伝われば十分。
今までに出会った最も酷いソースは、全ての行に日本語でコメントがいちいち書かれていたやつ。
for(i=0;i<10;i++){ /* iに0から1ずつ足しながら9まで繰り返す */
count += i; /* countに、iの数値を足す */
somfunction(count); /* 関数 somfunctionにcountを引き渡して呼び出す */
というようにアホかと思うくらいコメントをいちいち書いてあった。
コードを読めば何をしてるかくらいわかる。
いちいち書いてあるコメントがとても邪魔。
開発途中のそのソースを渡され、開発を引き継ぐように言われた時には死にたくなった。
Re:コメントは英語で書け (スコア:1)
「全行にコメントを入れろ」というコーディング規約があり、レビューでねちねちと……
頭に来て、意味のないコメントを量産。必要なコメントを削除して意図的に意味のないコメントに置換しました。
ローカルソースは普通のコメントの入ったソースですがメインのCVSに入れる際、コメント削除+機械コメント生成で……
notice : I ignore an anonymous contribution.