Source Code Comment Key for CS345 - Last Updated April 11, 2006

S) Simplicity 

C) Clarity

G) Generality

A) Automation 


1) The lab description asks for specific data points, your submittal makes it difficult or
impossible to find those particular data points.

2) Your data illustrates anomolies that your analysis fails to comment on.

3) Consider what you are trying to show with your graphics and how you are presenting that 
information.

4) Your graphs lack axis labels and/or legends.

5) The lab description specifies particular attributes of your code that are missing, e.g.
detecting the underlying platform and using that to set variables.

6) Minimize the amount of paper you use to turn-in an assignment.  Two sided printing and
re-using paper that has old material on the back side is fine, even encouraged.

Group Project API Deliverables

gp1) API Documentation
   gp1-a - Developer documentation on usage
   gp1-b - How to add data new sources

gp2) Test harness (with instructions) for the API

gp3) Data store information
   gp3-a - The data dictionary itself
   gp3-b - Scripts/instructions for creating the schema in the database instance
   gp3-c - Scripts/instructions to populate the database with your data sources
           and their source information