--- doc/homework/datastorage	2000/12/12 22:39:52	1.7
+++ doc/homework/datastorage	2002/01/30 17:08:47	1.11
@@ -12,11 +12,21 @@ resource.partid.weight     # points the
 
 resource.partid.maxtries   # maximum number of attempts the student can have
 
+resource.partid.type       # type of problem homework can be:
+                           # homework - randomized, graded, stored with 
+                           #            requesting user, full feeback
+                           # exam - randomized, graded, stored with 
+                           #        requesting user, minimal feedback
+                           # form - unrandomized, ungraded, stored with 
+                           #        specified user, full feedback
+                           # survey - unrandomized, ungraded, stored with 
+                           #          requesting user, full feedback
+
 
 
 <caparesponse needed: (has a default if nonexistant)>
 
-resource.partid.tol   # lots of possibilities here
+resource.partid.responseid.tol   # lots of possibilities here
                     # percentage, range (inclusive and exclusive),
 		    # variable name, etc
                     # 3%
@@ -24,8 +34,8 @@ resource.partid.tol   # lots of possibil
                     # .05+
                     # 3%+
                     # 0.5+,.005
-                    
-resource.partid.sig  # one or two comma sepearted integers, specifying the 
+
+resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
                      # number of significatn figures a student must use
 
 resource.partid.feedback   # at least a single bit (yes/no) may go with a
@@ -41,7 +51,8 @@ resource.partid.solved # if not set, pro
                 # incorrect_by_override == incorrect, instructor override
                 # excused == excused, problem no longer counts for student
                 # '' (empty) == not attempted
-
+                # ungraded_attempted == an ungraded answer has been
+                                          sumbitted and stored
 resource.partid.tries  # positive integer of number of unsuccessful attempts
                 # made, malformed answers don't count if feedback is
                 # on
@@ -49,14 +60,34 @@ resource.partid.tries  # positive intege
 resource.partid.awarded # float between 0 and 1, percentage of
                  # resource.weight that the stundent earned.
 
-resource.partid.responseid.submissons 
+resource.partid.award # final detailed award that was applied to the entire
+                      # part of the question, check awarddetail below for
+                      # possibilities
+
+resource.partid.previous # boolean, is this submission a previous submission
+
+resource.partid.responseid.submissons
                     # the student submitted string for the part.response
 
-resource.partid.responseid.awarddetail 
+resource.partid.responseid.awarddetail
                      # list of all of the results of grading the submissions
                      # in detailed form of the specific failure
+		     #Possible values:
+                     # EXACT_ANS, APPROX_ANS : student is correct
+                     # NO_RESPONSE : student submitted no response
+                     # MISSING_ANSWER : student submitted some but not
+                     #                   all parts of a response
+                     # WANTED_NUMERIC : expected a numeric answer and
+                     #                   didn't get one
+		     # SIG_FAIL : incorrect number of Significant Figures
+                     # UNIT_FAIL : incorrect unit
+                     # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
+                     # NO_UNIT : needed a unit but none was submitted
+		     # BAD_FORMULA : syntax error in submitted formula
+                     # INCORRECT : answer was wrong
+                     # SUBMITTED : submission wasn't graded
 
+		     # ERROR : unable to get a grade
 
-
-
-
+resource.partid.responseid.message (optional)
+		     # a message hat you need to send to the student