Changes between Version 6 and Version 7 of BoltRef

Timestamp:

Dec 4, 2007, 9:34:26 PM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -154 +154 @@
 === Select ===
 
+The '''select''' structure takes a set of units and a 'valuator' function.
+The valuator function returns the 'value' (i.e. the likely benefit) of showing
+the unit to the student.
+The unit for which this value is greatest is shown.
 {{{
 <?php
@@ -163 +167 @@
 return select(
     name('course'),
-    valuator(value),
+    valuator('value'),
     lesson(
         name('lesson 1'),
@@ -177 +181 @@
 
 
-== Memory refresh ==
-
-Bolt offers a ''memory refresh'' system that periodically repeats exercises
-and, if necessary, lessons.
-Memory research suggests that this is necessary for students to shift
-learning to long-term memory.
-This mechanism works as follows:
-
- * A sequence of ''inter-refresh intervals'' is defined.  For example, (7, 28) means that an exercise should be repeated 7 days after it is first taken, and then every 28 days thereafter.
- * Bolt provides a function that returns the set of items, for a given student, for which refresh is due.  Your course can use this function to implement a "Review now" button on web pages.
- * Bolt provides a "review mode" in which the student is presented with exercises due for review.
+== 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.
+
+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_set(
+    name('exer_set'),
+    num_to_show(1),
+    exercise(
+        name('exercise 1'),
+        filename('file_1.php')
+    ),
+    exercise(
+        name('exercise 1'),
+        filename('file_1.php')
+    ),
+    review(.3, basic_review()),
+    review(.7, int_review()),
+    refresh(array(7,14,28))
+);
+}}}
+
+=== Memory refresh ===
+