Changes between Version 18 and Version 19 of BoltIntro

Timestamp:

Nov 29, 2007, 12:06:13 PM (16 years ago)

Author:

davea

Comment:

--

BoltIntro

@@ -4 +4 @@
 and is designed to meet the needs of:
 
- * Skill aggregation projects (volunteers must be trained to perform various tasks);
- * Volunteer computing projects (educating participants can increase their enthusiasm and commitment, and attainment of given knowledge levels can be shown as a web site "status symbol").
-
-These areas have properties that are much different from those of formal education:
+ * Distributed thinking projects: volunteers must be trained to perform various tasks.
+ * Volunteer computing projects: educating participants can increase their enthusiasm and commitment, and attainment of given knowledge levels can be shown as a web site "status symbol".
+
+These areas have the following properties:
 
  * Churn: constant turnover, thousands of new students per day;
@@ -24 +24 @@
 
  * It guides students sequentially through the course;
- * If the student fails a quiz, they repeat one or more lessons and retry the quiz (Bolt courses are designed to be "fail-proof");
+ * If the student fails an exercise, they repeat one or more lessons and retry the exercise(Bolt courses are designed to be "fail-proof");
  * Each student's progress is recorded in a database, and when they return to the course later they resume at that point.
  * Bolt maintain an estimate of each student's mastery of the course material.
  
 In addition, Bolt lets you create better courses; specifically, you can
- * find out exactly how effective each lesson is;
  * make statistically valid comparisons of alternative lessons;
  * make "adaptive" courses in which different lessons are used for different groups of students
@@ -43 +42 @@
 
 An exercise is a PHP script.
-Here's an example containing a multiple-choice question
-(the '2' indicates that the correct answer is the last one):
+Here's an example consisting of a multiple-choice question:
 {{{
 <?php
-require_once('bolt.php');
+require_once('../inc/bolt_ex.inc');
 echo 'Conifers are so named because:';
 bolt_exclusive_choice(
    array(
+      'They carry their seeds in cones.'
       'They are cone-shaped.',
       'They originated during the Coniceous era.',
-      'They carry their seeds in cones.'
    ),
-   2
 );
 ?>
 }}}
+Each time the question is shown,
+the choices are shown in a random order.
+The correct choice is always the first element of the array.
+
 Here's an example that shows an image;
 a correct answer is a click in the indicated subrectangle.
 {{{
 <?php
-require_once('bolt.php');
-echo "Click on the dog's nose:";
+require_once('../inc/bolt_ex.inc');
+echo "Click on the dog's nose:<p>";
 bolt_image_rect(
    'dog.jpg',