Changes between Version 16 and Version 17 of BoltRef

Timestamp:

Dec 26, 2007, 12:27:42 PM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -304 +304 @@
 === Exercise set ===
 
-The 'exercise_set' structure specifies a set of exercises and a value 'num_to_show'.
-This number of exercises is chosen randomly and administered.
+The 'exercise_set' structure specifies a set of exercises and a value 'number' (default one).
+This number of exercises is chosen randomly (without replacement) and administered.
+
+The navigation links on the answer page of the last exercise
+may allow the student to review for and/or repeat the exercise set (see below).
 
 {{{
 exercise_set(
     name('exer_set'),
-    num_to_show(1),
+    number(1),
     exercise(
         name('exercise 1'),
@@ -319 +322 @@
         filename('file_1.php')
     ),
-    review(.3, basic_review()),
-    review(.7, int_review()),
+    repeat(.3, basic_review(), false),
+    repeat(.7, int_review(), true),
+    repeat(1.0, null, true),
     refresh(array(7,14,28))
 );
 }}}
 
-== Review ==
-
-Optionally, one or more '''review''' attributes can be given.
-Each specifies a grade threshold X and a list of review units.
-If the student's grade on the exercise set is less than some Y,
+== Exercise review and repeat ==
+
+The "repeat" items in an exercise set determine the student's options
+to review for and repeat the exercise set.
+(
+Each repeat item is a function call of the form
+{{{
+repeat(grade_threshold, review_unit, review_optional, repeat_optional);
+}}}
+The arguments are:
+ * grade_threshold: the highest grade to which this item applies
+ * review_unit: a unit that reviews the material assessed by for the exercise set.
+ * review_unit: whether the review is optional.
+ * repeat_optional: whether repeating the exercise set is optional
+
+A student's score on an exercise set is the average score of the selected exercises.
+Call this Y;
+the "selected repeat item" is the one with the greatest X such that Y < X.
+
+If there is no such repeat item, the student is not given an option
+to repeat the exercise set; i.e., they see only a Next button.
+
+Otherwise let R be the selected repeat item.
+If R.repeat_optional is true, the student sees 
 
 == Memory refresh ==