コメント記法の効果

みなさん、コメントありがとうございます。
＞hokkyさん、きむこうさん、kirifueさん

　私の会社では実際のコメント記述はプロジェクト毎のコーディネーション・プロシージャで決定されているので、それに従います。英語できちんと記述されているものもあれば、コメントは一切無く、プログラム設計書で十分に表現する。時には、変数名、関数名なども意味を持たせない表記になっていたりします。
　こういった現場での対応は、応用にあたると判断して、基本的な「しつけ」を新入社員にしています。Doxvgenを使っている部署もありますが、これがまだ全社標準的に使われていないので、研修に組み込むのは見送りました。来年以降はアセンブラとJavaの言語研修に切り替えようかとも思っているのですが、C言語のような発見的な教育効果が得られるかどうか、若干疑問なので、その点も検討しながら、来年度の教育プランを練っていきたいと思っています。

C言語、懐かしいです。cgiですら、C言語を使ってましたっけ。メモリリークにはよく悩まされました…。
慣れてくるとコメントより先にコードを打ち込んでしまいがちですが、新人君にはコメントから記述させることが効果的なんですね。なるほど。
また、hokkyさんがおっしゃるように「Doxygen」を利用すると効率的ですが、そういうツールを利用するかは約束事なので、名夢子さんの会社ではいかがでしょうか。
個人的にはコメントをさぼっていると、後で自分でも分からなくなることがよくあるので、必要なことは必要となる箇所に記述することを心がけてます。てゆーか「コメントが必要なコードは書くな」って言われそう？！
海外の方と仕事をするときは仕方なく英語で書いてますが、これも時と場合と約束事によりますよね。

今の現場は逆に、
* コメントは書かない
* コメントが必要なコードは書くな
という方針です。

コメント無いとどうもぱっと見わからなくなることが結構ありますね

最近、ソフトウエアの開発は海外のチームとの共同開発が多くなってきているし、今後も増えていくでしょうから、コメントは日本語ではなく、英語で書いた方が良い様な気がしますが、どうなのでしょうね？まあ、研修だから日本語なのかもしれませんが。

あと、Doxygen (Javadoc)のようなものは導入していないのでしょうか？せっかく研修なので、そういうツールを使ったコメントの書き方も教えた方が良いんじゃないかなぁとちょっと思ってしまいました。