【PHP】自作スクリプト発表会
■ このスレッドは過去ログ倉庫に格納されています
0653nobodyさん
2006/03/06(月) 19:28:05ID:???コメントの重要性を理解している点は評価できるんですが、
そんなあなたには「粒度」という言葉をプレゼントします。
処理にも、大きい単位から小さい単位までいろいろあるわけで、
すべてのコメントを小さい単位に合わせて書いたら、
ソースコードの見通しが全く見えなくなって、
コメントがないのと同じくらい意味がなくなってしまうのですよ。
あと、コメントの大事なポイントは、
全体の流れの中においてその処理が持っている意味を書くこと。
その処理がどういう動作をしているかは書かなくてもいいです。
そんなことは、PHPの文法が分かる人間だったら誰でも分かるんだから
よっぽど凝っていて複雑なアルゴリズムを書くとき以外には必要ないです。
というわけで、今後はコメントの書き方を要研究すべし。
ソースの中身は面倒なので読まなかったけど、パッと見て思ったのはそんなところ。
■ このスレッドは過去ログ倉庫に格納されています