Changes between Version 32 and Version 33 of BoltRef

Timestamp:

Aug 14, 2008, 9:12:56 AM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -265 +265 @@
 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).
+This structure can be used to implement
+ * "experiments" where different lessons are compared;
+ * "adaptive courses" where different lessons are shown to different types of students.
+or a mixture of the two.
 
 {{{
@@ -292 +292 @@
 
 
+=== 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).
+
 === Exercise set ===
 
@@ -321 +350 @@
 );
 }}}
-
 
 == Exercise review and repeat ==
@@ -373 +401 @@
 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).
-
-