[WWcvs] webwork2: added some notes at the bottom.

[Sam H. v. a. <we...@ma...>]

Log Message:
-----------
added some notes at the bottom.

Modified Files:
--------------
    webwork2/lib/WeBWorK/ContentGenerator/Instructor:
        Scoring.pm

Revision Data
-------------
Index: Scoring.pm
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /webwork/cvs/system/webwork2/lib/WeBWorK/ContentGenerator/Instr=
uctor/Scoring.pm,v
retrieving revision 1.51
retrieving revision 1.52
diff -Llib/WeBWorK/ContentGenerator/Instructor/Scoring.pm -Llib/WeBWorK/C=
ontentGenerator/Instructor/Scoring.pm -u -r1.51 -r1.52
--- lib/WeBWorK/ContentGenerator/Instructor/Scoring.pm
+++ lib/WeBWorK/ContentGenerator/Instructor/Scoring.pm
@@ -797,3 +797,41 @@
=20
 }
 1;
+
+__END__
+
+Here's pretty much everything I can think of that we can get out of the =
database
+or calculate:
+
+for each set, we have a few rows of non-user-specific data above the stu=
dent rows
+(we could just have additional columns for these values, but they'd have=
 the same value in every row)
+	set_id
+	optional other set data (dates, etc)
+	per-problem data (usually not shown, but available if needed)
+		problem_id
+		problem value
+	for all problems in the set
+		total value
+for each student (one row) we need columns for:
+	user_id and/or student_id
+	optional other user data (first_name/last_name, section, recitation, et=
c)
+	per-set data
+		per-problem data (usually not shown, but available if needed)
+			status
+			score =3D value*status
+			number of attempts
+			number of correct attempts
+			number of incorrect attempts
+		for all problems in the set
+			total status
+			total score
+			total number of attempts
+			average number of attempts
+			total number of correct attempts
+			average number of correct attempts
+			total number of incorrect attempts
+			average number of incorrect attempts
+			index =3D ( total_status / total_value )**2 / average_number_of_attem=
pts
+
+"value" is the weight of the problem, in the range [0,=83), usually 1.
+"status" is the correctness of a problem, in the range [0,1].