2007年8月13日(月)

« 【ココログ】目次スクリプトを改修 | トップページ | 【ココログ】コメント展開表示ボタンを付けるスクリプト »

1年前の僕にはもう2度と会えない

ソースコードにはちゃんとコメントつけましょうね、ってお話。
久しぶりに目次スクリプト見てみたのですが、作った本人にも何がどうなっているのかよくわかりません(苦笑)。
もとが思いつきで作ったスクリプトで、継ぎ足しを繰り返したこともあり、すっかりスパゲッティになっているということもありますが……。
個人的には、あまりに冗長にコメントが付いているとかえって見難いので、関数や変数等の名前をそれっぽくして(機能に関連した名称を用いることで)、コメントは最小限におさえる、という方針を好むのですが……その最小限のコメントすらついていないと、こうなるという悪い見本です。
ある程度の長さを持ったソースコード書くなら、適度なコメントを入れるようにしないといけませんなぁ、と改めて感じたしだい。
他人に見られることを前提にする場合はもちろん、未来の自分も結構別人なので。
1年前、どころか、1日前でもあやしいことも……これは日記(ブログ)とかを書く場合にも言えるか、な?
でも、わかっちゃいるけど、なかなか実行できないんですよねぇ(苦笑)

この記事をニフティクリップβに追加 この記事をはてなブックマークに追加 2007/08/13(月) 14:53 | | 記事の編集(管理者用)

風柳へひとこと(web拍手) 

ひとりごと」カテゴリの記事

トラックバック

この記事のトラックバックURL:

記事との関連性が薄いものやSPAM等、管理人が不適切と見なしたトラックバックについては予告無く削除する場合が有ります。悪しからずご了承下さい。

この記事のトラックバックURL:
http://app.cocolog-nifty.com/t/trackback/161784/16098164

この記事へのトラックバック一覧です: 1年前の僕にはもう2度と会えない:

コメント

コメントを書く