藤沼@イイガです。
遅れていた分を送ります。本当にごめんなさい。m(__)m
必要であれば HTML 形式のも送付します。
---------------------------------------------------------------------
Class comments
クラスコメント
私たちは、クラスが何のために存在し、そして時にそれがどのように動作す
るかを記述するために、クラスコメントを用います。私たちは多分、多くの
場合十分にそれをしないでしょうし、多分そうすべきほどに最新の状態を保
たないでしょう。
私の個人的意見では、これは、クラスコメントを厳しく取り締まるのではな
く、明瞭なコードを書くことに強く焦点を当てることを主張します。開発者
の本質は、コードを書くことにあり、文書を作成することにはありません。
最良のプロセスとは、本質を伴って機能するのであり、それに刃向かって機
能するのではありません(ソフトウェア開発における木の抱擁理論)。
依然として。。。ほとんどのクラスにとってクラスコメントは実に有益です。
あなたが新しいクラスを作成したときにそれを作成してください。
---------------------------------------------------------------------
オリジナル http://www.xprogramming.com/
Copyright (c) 1999, REJeffries et al. (ronjeffries@....org)
---------------------------------------------------------------------
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Kentaro Fujinuma / IIGA Co., Ltd. / Network Administrator
Contact: E-mail: fuji@....jp
Tel: 03-5296-0389 / Fax: 03-5296-0386
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-