Changes between Version 17 and Version 18 of BoltRef

Timestamp:

Dec 26, 2007, 1:40:35 PM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -310 +310 @@
 may allow the student to review for and/or repeat the exercise set (see below).
 
+Exercise sets may not be nested.
+
+Example:
 {{{
 exercise_set(
@@ -322 +325 @@
         filename('file_1.php')
     ),
-    repeat(.3, basic_review(), false),
-    repeat(.7, int_review(), true),
-    repeat(1.0, null, true),
+    repeat(.3, basic_review(), false, false),
+    repeat(.7, int_review(), true, false),
+    repeat(1.0, null, null, true),
     refresh(array(7,14,28))
 );
@@ -341 +344 @@
  * 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.
+ * review_optional: whether the review is optional.
  * repeat_optional: whether repeating the exercise set is optional
 
@@ -352 +355 @@
 
 Otherwise let R be the selected repeat item.
-If R.repeat_optional is true, the student sees 
+If R.repeat_optional is true, a Next button is shown.
+If R.review_optional is true, a "Repeat" button is shown.
+If R.review_unit is present, a "Review" button is shown.
+
+Thus, in the example above, the student's options are:
+
+|| grade || options ||
+|| [0, .3) || review and repeat exercise ||
+|| [.3, .7) || review and repeat exercise, or repeat exercise ||
+|| [.7, 1) || repeat exercise, or continue ||
+|| 1 || continue ||
 
 == Memory refresh ==
@@ -358 +371 @@
 If a '''refresh()''' argument is given to exercise_set(),
 then when the set is completed by a student it is added to
-a "refresh schedule", to be repeated at a later time.
+a "refresh schedule".
+Each element in a refresh schedule specifies
 The intervals (in days) are given as arguments to refresh().