Index: [Article Count Order] [Thread]

Date:  Thu, 18 May 2000 19:56:16 +0900
From:  Kentaro Fujinuma <fuji-k@....jp>
Subject:  [XP-jp:00364] XPractices 	【 07. Class comments 】
To:  extremeprogramming-jp@....jp (extremeprogramming-jp ML)
Message-Id:  <200005181955.CHC40610.J-GLKV@....jp>
Posted:  Thu, 18 May 2000 19:56:33 +0900
X-Mail-Count: 00364

藤沼@イイガです。

遅れていた分を送ります。本当にごめんなさい。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
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-