Browse files

Help help for second release

  • Loading branch information...
1 parent 1192a9e commit a78e874f6b6aa0d8ca4010568fb93873740dba27 rkingdon committed Feb 26, 2004
23 lang/en/help/lesson/maxattempts.html
@@ -0,0 +1,23 @@
+<p align="center"><b>The Maximum Number of Attempts (by a Student)</b></p>
+<p>This value determines the maximum number of attempts a Student has
+ in aswering <b>any</b> of the questions in the lesson. In the case of questions
+ which do not provide the answer, for example Short Answer
+ and Numerical questions, this value provides a necessary <i>escape routine</i> to
+ the next page in the lesson. </p>
+<p>The default value is 5. Smaller values may discourage the student
+ from thinking about the questions. Larger values may lead to more
+ frustration.</p>
+<p>Setting this value to one gives the students just one chance to answer each
+ question. This gives a similar type of assignment to the Quiz module except
+ that the questions are presented on individual pages.</p>
+<p>Note that this value is global parameter and that it applies to all the
+ questions in the lesson regardless of their type.</p>
+<p>Note that this parameter does <b>not</b> apply to teachers checking
+ of questions or navigating through the lesson. Checking the number of attempts
+ relies on values stored in the database and question attempts by teachers are
+ not recorded. The teacher should after all know the answers!</p>
10 lang/en/help/lesson/maxpages.html
@@ -0,0 +1,10 @@
+<p align="center"><b>Number of Pages (Cards) to Show</b></p>
+<p>This parameter is only used in Flash Card type lessons. The default value is zero
+ which means that all the Pages/Cards are shown in a lesson. Setting this parameter to
+ a non-zero value shows that number of pages. After that number of Page/Cards have been
+ shown the end of lesson is reached and the student is shown their grade.</p>
+<p>If this parameter is set to a number greater than the number of pages in the lesson then
+ the end of the lesson is reached when all the pages have been shown.</p>
22 lang/en/help/lesson/nextpageaction.html
@@ -0,0 +1,22 @@
+<p align="center"><b>Action after a Correct Answer</b></p>
+<p>The usual action is to follow the jump as specified in the answer. In most cases
+ this will probably show the Next Page of the lesson. The student is taken through
+ the lesson in a logical way, beginning at the start and ending at the end.</p>
+<p>However, the lesson module can also be used as a type of <i>Flash Card</i> assignment.
+ The student is show some information (optional) and a question in basically a random
+ order. There is no set beginning and no set end. Just a set of <i>Cards</i> shown one after
+ another in no particular order.</p>
+<p>This option allows two very similar variants of Flash Card behaviour. The
+ option "Show an unseen page" never shows the same page twice (even if the student
+ did <b>not</b> answer the question associated with the Card/Page correctly). The other
+ non-default option "Show an unanswered page" allows the student to see pages that
+ may have appeared before but only if they answered the associated question wrongly.</p>
+<p>In either of these Flash Card-type lessons the teacher can decide to use either all the
+ Cards/Pages in the lesson or just a (random) sub-set. This is done through the &quot;Number
+ of Pages (Cards) to show&quot; parameter.</p>
119 lang/en/help/lesson/questiontypes.html
@@ -0,0 +1,119 @@
+<p align="center"><b>Question Types</b></p>
+<p>The types of Questions currently supported by the Lesson module are:
+<li><p><b>Multichoice</b> This is the default question type. Multichoice questions
+ are popular questions where the student is asked to choose one answer from a
+ set of alternatives. The correct answer takes the student further into the
+ lesson, the wrong answers do not. The wrong answers are sometimes called the
+ &quot;distractors&quot; and the utility of these questions often rely more
+ on the quality of the distractors than either the questions themselves or their
+ correct answers.</p>
+<p> Each answer can optionally have a response. If no response is
+ entered for an answer then the default reponse &quot;That's the Correct
+ Answer&quot; or &quot;That's the Wrong Answer&quot; is shown to the student.
+ </p>
+<p>It is possible to have more than one correct answer to a multichoice question.
+ The different correct answers may give the student different responses and
+ jump to different (forward) pages in the lesson but
+ do not vary in their grades, (that is, some answers are <b>not</b> more correct
+ than others, at least in terms of grade.) It is possible for all the answers
+ to be correct and they might take the student to different (forward) parts of
+ the lesson depending on which one is choosen.</p>
+<p>There is variant of Multichoice questions called <b>&quot;Multichoice
+ Multianswer&quot;</b> questions. These require the student to select all the
+ correct answers from the set of answers. The question may or may not tell
+ the student how many correct answers there are. For example &quot;Which of the
+ following were US Presidents?&quot; does not, while "Select the two US
+ presidents from the following list." does. The actual number of correct
+ answers can be from <b>one</b> up to the number of choices. (A Multichoice
+ Multianswer question with one correct answer <b>is</b> different from a
+ Multichoice question as the former allows the student the possibility of
+ choosing more than one answer while the latter does not.)</p>
+<p>Again the correct answers are flagged using forward jumps, the wrong answers
+ by same page or backward jumps. When there is more than one correct answer
+ the jumps should all go to the same page, similarily with the wrong answers.
+ If that is <b>not</b> the case a warning is given on the teacher's view of
+ the lesson. The correct response, if required, should be given on the first
+ correct answer and the wrong response, if required, should be on the first
+ wrong answer. Responses on the other answers are ignored (without warning).
+ </p></li>
+<li><p><b>Short Answer</b> The student is prompted for a short piece of text.
+ This is checked against one or more answers. Answers can be either correct
+ or wrong. Each answer can optionally have a response. If no response is
+ entered for an answer then the default reponse &quot;That's the Correct
+ Answer&quot; or &quot;That's the Wrong Answer&quot; is shown to the student.
+ If the text entered does not match any of the answers the question is wrong
+ and the student is shown the default wrong response.
+ </p>
+<p>By default the comparisons ignore the case of the text. There is an option
+ to make the comparisons case sensitive.</p></li>
+<li><b>True/False</b> The answer to this type of question only has two options,
+ true or false. The student is prompted to choose which is the correct
+ option. This type of question is basically a Multichoice question with just
+ two choices.</p></li>
+<li><p><b>Matching</b> These are quite powerful and flexible questions. They
+ consist of a list of names or statements which must be correctly matched
+ against other list of names or statements. For example &quot;Match the
+ Capital with the Country&quot; with the two lists Japan, Canada, Italy and
+ Tokyo, Ottawa, Rome. It is possible to have repeated entries in one of the
+ lists but care should be taken to make the repeats identical. For example
+ &quot;Identify the type of these creatures&quot; with the lists Sparrow,
+ Cow, Ant, Dog and Bird, Animal, Insect, Animal. </p>
+<p>When creating this type of question the items for the first list go into the
+ Answer boxes and items for the second list go into the Response boxes. Once
+ created a more sensible labelling scheme is shown. When the student
+ successfully matches the items the jump on the first answer is used. An
+ unsuccess answer jumps to the page on the second answer. The question does
+ <b>not</b> support custom responses, the student is told how many matches
+ are correct or if all the matches are correct.</p>
+<p>Unlike the Multichoice question where the choices are shown in a random
+ order, the first list of items is <b>not</b> shuffled but shown in the same
+ order as entered. This allows for <b>&quot;Ordered&quot;</b> questions to be
+ constructed. Consider the question &quot; Put the following into the order
+ they were born, the earliest first&quot; with the lists 1., 2., 3., 4. and
+ Longfellow, Lawrence, Lowell, Larkin. The second list is shuffed before
+ being used in the question, of course.</p></li>
+<li><p><b>Numerical</b> This type of question requires a number as the answer.
+ In it's simplest form it requires just one answer to be specified. For
+ example &quot;What is 2 plus 2?&quot; with the answer 4 given a forward
+ jump. However, it is better to specify a range because the internal rounding
+ of numerical values can make single numeric comparisons rather hit or miss.
+ Thus, if the question were &quot;What is 10 divided by 3&quot; it would be
+ necessary to give the answer as <b>&quot;Minimum:Maximum&quot;</b>, that
+ is <b>two</b> values separated by a colon (:). Thus if 3.33:3.34 is given as the
+ acceptible range for the answer, then the answers 3.33, 3.333, 3.3333...
+ would all be taken as correct answers. &quot;Wrong&quot; answers would
+ include 3.3 (less than the minimum) and 3.4 (greater than the maximum).</p>
+<p>More than one correct answer is allowed and the answers can be either single
+ or pair of values. Note that the order in which the answers are tested is
+ Answer 1, Answer 2... so some care needs to taken if the desired response
+ is to appear. For example the question &quot;When was Larkin born?&quot;
+ could have the single value of 1922, the exact answer, and the pair of
+ values 1920:1929, the 20's, as the less exact answer.The order in which
+ these values should be tested is, obviously, 1922 then 1920:1929. The
+ first answer might have the response &quot;That's exactly right&quot;
+ while the other answer's response might be &quot;That's close, you've got
+ the right decade&quot;</p>
+<p>Wrong answers can be given but depending on their actual range, care should
+ be taken to place them after the correct answers. For example in adding the
+ wrong answer 3:4 to the &quot;10 divided by 3&quot; question it needs to come
+ after the correct answer. That is the answers are ordered 3.33:3.34 (the
+ &quot;correct&quot; answer) then 3:4 (the &quot;wrong&quot; answer, but
+ not wildly wrong answer!).</p></li>

0 comments on commit a78e874

Please sign in to comment.