プログラムの先頭にはヘッダコメントを設ける

仕様書は、プログラムの保守、機能拡張を行うときに参考にします。しかし、最終的には何を見るかというと、やはりプログラムです。
仕様書などは時としてプログラムの更新と同期していないことがありますが、プログラムは唯一真実を語るものです。
したがいまして、プログラムには仕様が明記されていなければならないのです。
仕様書よりは有効な開発支援となるものですから、必ずコメントを記述しています。(日本語で記述しています)
ヘッダー部は、プログラムが使用されなくなるまでソースプログラムについてまわるものなのです。

コメントを残す

メールアドレスが公開されることはありません。