プログラムは、問題を解決する一連の処理手順(アルゴリズム)を表しています。
下にあげる点に注目して、必要なコメントをつけよう。
C1 | 変数やデータ構造が、どんな情報を表現しているか |
C2 | 定数が、どんな情報を表現しているか |
C3 | 変数が、プログラムが表現している手続きの中で、どのような役割をしているか |
C4 | ひと固まりのプログラム(ブロック)や関数が表現している手続きの概要 |
C5 | 1行程度のプログラムが表現している手続き |
S1 | 行の上に書くブロックコメントと、プログラムの後ろに書く行末コメントを使い分けよう |
S2 | コメント中の空白や行揃えなど、できるだけスタイルを統一しよう |
S3 | 簡潔でわかりやすい表現を心がけよう |