Changes between Version 6 and Version 7 of BoltRef


Ignore:
Timestamp:
Dec 4, 2007, 9:34:26 PM (17 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • BoltRef

    v6 v7  
    154154=== Select ===
    155155
     156The '''select''' structure takes a set of units and a 'valuator' function.
     157The valuator function returns the 'value' (i.e. the likely benefit) of showing
     158the unit to the student.
     159The unit for which this value is greatest is shown.
    156160{{{
    157161<?php
     
    163167return select(
    164168    name('course'),
    165     valuator(value),
     169    valuator('value'),
    166170    lesson(
    167171        name('lesson 1'),
     
    177181
    178182
    179 == Memory refresh ==
    180 
    181 Bolt offers a ''memory refresh'' system that periodically repeats exercises
    182 and, if necessary, lessons.
    183 Memory research suggests that this is necessary for students to shift
    184 learning to long-term memory.
    185 This mechanism works as follows:
    186 
    187  * 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.
    188  * 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.
    189  * Bolt provides a "review mode" in which the student is presented with exercises due for review.
     183== Exercise set ==
     184
     185The 'exercise_set' structure specifies a set of exercises and a value 'num_to_show'.
     186This number of exercises is chosen randomly and administered.
     187
     188Optionally, one or more '''review''' attributes can be given.
     189Each specifies a grade threshold X and a list of review units.
     190If the student's grade on the exercise set is less than some Y,
     191
     192
     193{{{
     194exercise_set(
     195    name('exer_set'),
     196    num_to_show(1),
     197    exercise(
     198        name('exercise 1'),
     199        filename('file_1.php')
     200    ),
     201    exercise(
     202        name('exercise 1'),
     203        filename('file_1.php')
     204    ),
     205    review(.3, basic_review()),
     206    review(.7, int_review()),
     207    refresh(array(7,14,28))
     208);
     209}}}
     210
     211=== Memory refresh ===
     212