Changes between Version 26 and Version 27 of BoltRef

Timestamp:

Jan 25, 2008, 2:47:20 PM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -258 +258 @@
 Sequences were described above.
 
-=== Random ===
-The '''random''' control structure selects randomly (without replacement) from a set of units.
-{{{
-<?php
-return random(
-    name('foobar'),
-    number(2),
-    lesson(
-        name('lesson 1'),
-        filename('bolt_sample_lesson1.php')
-    ),
-    lesson(
-        name('lesson 2'),
-        filename('bolt_sample_lesson2.php')
-    ),
-    lesson(
-        name('lesson 3'),
-        filename('bolt_sample_lesson3.php')
-    ),
-);
-?>
-}}}
-
-If 'number()' is given, that many units are shown; the default is one.
-
-The 'without replacement' applies across multiple visits to the same structure
-(e.g. because of review or refresh).
-
 === Select ===
 
@@ -291 +263 @@
 which returns the predicted benefit of showing the unit to the student.
 The unit for which this value is greatest is shown.
+The value function may be partly or entirely random.
+
+This structure has a special role; it is used
+ * to implement "experiments" where different lessons are compared;
+ * to implement "adaptive courses" where different lessons are shown to different types of students.
+(or a mixture of the two).
+
 {{{
 <?php
@@ -343 +322 @@
 );
 }}}
+
 
 == Exercise review and repeat ==
@@ -394 +374 @@
 the student may begin refresh for set A while
 partway through refresh for set B.
+
+=== Random ===
+The '''random''' control structure selects randomly (without replacement) from a set of units.
+{{{
+<?php
+return random(
+    name('foobar'),
+    number(2),
+    lesson(
+        name('lesson 1'),
+        filename('bolt_sample_lesson1.php')
+    ),
+    lesson(
+        name('lesson 2'),
+        filename('bolt_sample_lesson2.php')
+    ),
+    lesson(
+        name('lesson 3'),
+        filename('bolt_sample_lesson3.php')
+    ),
+);
+?>
+}}}
+
+If 'number()' is given, that many units are shown; the default is one.
+
+The 'without replacement' applies across multiple visits to the same structure
+(e.g. because of review or refresh).
+
+