わたしのブログ

・ソフトウェアエンジニアの意識調査

私は、１９９９年から約二年間で延べ３００人以上のソフトウェアエンジニアに対して、コードレビューに関するガイダンスやプログラミング作法に関する教育を実施し、その中で次のような質問をしてきました。

Q1.今までに、「自分が書いているコードを他人が読んで理解できるか」を意識してプログラミングをしてきましたか？

Q2.今までに、他人が書いたコードのバグ修正や保守作業で、プログラムが読みにくいために苦労したことはありますか？

Q1.で「はい」と答えた人は１割以下で、Q2.で「はい」と答えた人は９割以上でした。

つまり、自分では他人が読めるかどうかは気にしないでプログラミングしているにもかかわらず、他人のプログラムが読めなくて苦労したと回答する人がほとんどだったのです。

うん、これはそうでしょうなぁ。だから、ドキュメント類は、キチンと書きましょうね。まぁ、ドキュメント類も人によって見やすい人と、見にくい人がいますから。ソース内のコメントも、わかりやすい人と一行ずつコメント書く人やまったく書かない人もいたり、英語でのコメントの人もいます。人によって違うですよ。

では、また今度。