Review - Software Development Standards and Conventions
Brian Sidharta 08 Dec 2002

This is an informal review report of the Software Development
Standards and Conventions, authored by Ross Paul et.al.
Commented sections are bulleted with a hyphen "-", with the reviewer's
comments following each item.

- 1.2 Naming Conventions
  "Interface names should be adjectives..."  Blah. I don't like this item.

- 1.3.2 Header Formats
  The line "* @version $Revision$" should be added to the class header
  javadoc.  The Revision history starting with "//" is excessive in my
  opinion--good enough revision history can be maintained in CVS.

  The optional line "* @exception ..." can be included in the method
  javadoc.  Also maybe take out the revision history.  Excessive and
  won't be followed.

- 1.7 Statements
  Chain assignments.  Add an example such as "a = b = c"

- 1.8 Programming Practices
  "Use 'FIXME'..."  Also add "TODO" or "TBD"?