瞼の裏に弾幕が飛び交う程度の能力 - 永夜抄Normalはそれなりに難しい。
自分自身はコメントですら英語で書きます。理由としては、Windows版のOsaka-等幅では、日本語の文字が綺麗に表示されない、英語圏のWebプレビューでは文字化けするというのもありますが、何よりコメント自体ほとんど書かないからです。自分の書いた中にコメントは#regionブロックとXML以外のコメントがないコードも結構あります。
とは言っても、MSDNなんかのサンプルコードなどで日本語のコメントがないとやっぱり苛ってきます。
投稿日時 : 2008年6月1日 8:14
わたしの場合、ソース自体は英語が基本で略した変数名はつけません。(C++です) 区分を分ける必要があれば、namespaceつかって分けています。 その上で、ヘッダに関数・変数のコメントを日本語で書いて、ヘッダ＝簡易仕様書として使えるようにしています。(JavaDocのイメージですね、HTMLまでは作りませんが・・・) ただ、海外向けの場合は全部英語(バッタもん)になってます(^^ >とは言っても、MSDNなんかのサンプルコードなどで日本語のコメントがないとやっぱり苛ってきます。 そうですね(^^。 読み手としては、ドキュメントは日本語のほうがわかりやすいです。見ただけで頭に入ってくる「気が」します。英語は音(おん)を辿らないと意味が入ってきません。 それと、MSDNの記載が日本語版と英語版で内容が違うのはやめてほしいですね。
個人で開発する分には英語でコメントも かまわないけど、チーム開発した場合に 英語出来る人ばかりではないから、 その場合は、やはり日本語になるのかな
仕事だと再利用可能性ってのがあるから、コメント至上主義的な部分はあるでしょうね。 自分はクラスライブラリにするか、コードをコピペするならむしろコメントは邪魔な人なのですが。
名前空間は英語表記？
Powered by: Copyright © Hirotow（特急きりしま16号）