Changes between Version 12 and Version 13 of BoltRef

Timestamp:

Dec 13, 2007, 12:05:37 AM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -8 +8 @@
  * '''Exercises''', used for reinforcement and/or assessment.
  * A '''course document''' describing the order in which lessons and exercises are shown.
+
+To use Bolt:
+ * [MakeProject create a BOINC project].
+ * Put your lessons, exercises and course document in the project's html/user directory
+ * Edit and run the html/ops/bolt_setup_sample.php script to create one or more courses.
 
 == Lessons ==
@@ -135 +140 @@
 }}}
 
-== Changing course documents ==
-
-Course documents need not be static.
-You can change them whenever you want (that's the point of Bolt).
-
-What happens if a course changes while
-students are in the middle of it?
-The general answer is the Bolt recovers as gracefully as possible.
+=== Changing course documents ===
+
+Course documents can change over time.
+In fact, that's the whole point of Bolt:
+to constantly study the effectiveness of course materials,
+and change the course based on the results of that study.
+
+If a course changes while students are in the middle of it,
+Bolt recovers as gracefully as possible.
 For each student, Bolt maintains a "course state" - a set of data,
 for each control structure that the student has visited in the course,
@@ -164 +170 @@
  * If you change the sequence to (red, yellow) then the student will have finished the sequence.
 
-== Nesting and functions ==
+=== Nesting and functions ===
 
 Control structures may be nested.
@@ -198 +204 @@
 }}} 
 
-== Names and state ==
+=== Logical names and state ===
 
 In general, units must have unique logical names.