From: rkingdon Date: Sat, 27 Mar 2004 04:07:37 +0000 (+0000) Subject: Version 3 updates X-Git-Url: http://git.mjollnir.org/gw?a=commitdiff_plain;h=44cbe38d7f93663770ac7597da402096c23f85d8;p=moodle.git Version 3 updates --- diff --git a/lang/en/help/lesson/handlingofretakes.html b/lang/en/help/lesson/handlingofretakes.html new file mode 100644 index 0000000000..ef38fdaf62 --- /dev/null +++ b/lang/en/help/lesson/handlingofretakes.html @@ -0,0 +1,9 @@ +

Handling of Re-takes

+ +

When students are allowed to re-take the lesson, this option allows the + teacher to show the grade for the lesson in, for example, the Grades page, + as either the mean, this is average, of the grades over the first + and subsequent tries or as the grade from the students' best tries.

+ +

This option can be changed at any time.

+ diff --git a/lang/en/help/lesson/import.html b/lang/en/help/lesson/import.html new file mode 100644 index 0000000000..6e4292c4e3 --- /dev/null +++ b/lang/en/help/lesson/import.html @@ -0,0 +1,111 @@ +

Importing new questions

+ +

This function allows you to import questions from + external text files, uploaded through a form. + +

A number of file formats are supported: + +

GIFT format

+ + +

Aiken format

+ + + +

Missing Word

+ + + +

AON

+ + + +

Blackboard

+ + +

Course Test Manager

+ + +

Custom

+ + + +

More formats are yet to come, including WebCT, IMS QTI and whatever else + Moodle users can contribute!

diff --git a/lang/en/help/lesson/maxanswers.html b/lang/en/help/lesson/maxanswers.html index a72db12f7f..6b7c5f213c 100644 --- a/lang/en/help/lesson/maxanswers.html +++ b/lang/en/help/lesson/maxanswers.html @@ -1,7 +1,14 @@

The Maximum Number of Answers in a Lesson

This value determines the maximum number of answers the teacher can use. - The default value is 4. If the lesson uses only TRUE or FALSE + The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

-

It is safe to change this value in a lesson with existing content.

+

This parameter also sets the maximum number of Branches that can be used in + a Branch Table.

+ +

It is safe to change the value of this parameter in a lesson with existing + content. In fact if you want to add a question with many choices or a long + Branch table changing this parameter will be necessary. After the (unusual) + question or BranchTable has been added this parameter can be reduced to a + more "standard" value.

diff --git a/lang/en/help/lesson/minquestions.html b/lang/en/help/lesson/minquestions.html new file mode 100644 index 0000000000..f7c1659731 --- /dev/null +++ b/lang/en/help/lesson/minquestions.html @@ -0,0 +1,31 @@ +

The Minimum Number of Questions in a Lesson

+ +

When a lesson contains one or more Branch Tables the teacher should + normally set this parameter. Its value sets a lower limit on the number of + quesions seen when a grade is calculated. It does not force students + to answer that many questions in the lesson

+ +

For example, setting this parameter to, say, 20, will ensure that grades are + given as though the students have seen at least this number of + questions. Take the case of a student who only looks at a single branch in + a lesson with, say, 5 pages and answers all the associated questions + correctly. They then choose to end the lesson (assuming there is that option + in the "top level"Branch Table, a reasonable enough assumption). + If this parameter were left unset their grade would be 5 out of 5, that is + 100%. However, with it set to 20 their grade would be reduced to 5 out of + 20, that is 25%. In the case of another student who goes through all the + branches and sees, say, 25 pages and answers all but two of the questions + correctly, then their grade would be 23 out of 25, that is 92%.

+ +

If this parameter is used, then the opening page of the lesson should say + something like:

+ +

In this lesson you are expected to attempt at least n questions. + You can attempt more if you wish. However, if you attempt less than n + questions your grade will be calculated as though you attempted n.

+ +

Where obviously "n" is replaced by the actual value this parameter + has been given.

+ +

When this parameter is set students are told how many questions they + have attempted and how many they are expected to attempt. diff --git a/lang/en/help/lesson/nextpageaction.html b/lang/en/help/lesson/nextpageaction.html index 366048f528..74b1357ad7 100644 --- a/lang/en/help/lesson/nextpageaction.html +++ b/lang/en/help/lesson/nextpageaction.html @@ -5,7 +5,7 @@ the lesson in a logical way, beginning at the start and ending at the end.

However, the lesson module can also be used as a type of Flash Card assignment. - The student is show some information (optional) and a question in basically a random + The student is shown some information (optional) and a question in basically a random order. There is no set beginning and no set end. Just a set of Cards shown one after another in no particular order.

diff --git a/lang/en/help/lesson/overview.html b/lang/en/help/lesson/overview.html index 0083ff2e81..9c0acedec6 100644 --- a/lang/en/help/lesson/overview.html +++ b/lang/en/help/lesson/overview.html @@ -1,8 +1,10 @@

Overview

    -
  1. A lesson is made up of a number of pages. -
  2. A page contains some content and it normally ends with a question. +
  3. A lesson is made up of a number of pages and optionally branch + tables. +
  4. A page contains some content and it normally ends with a + question. Thus the term Question Page.
  5. Each page normally has a set of answers.
  6. Each answer can have a short piece of text which is displayed if the answer is chosen. This piece of text is called the response. @@ -21,10 +23,12 @@ (Although if the jumps are not changed from their default values the two are strongly related.) The teacher has the option to check the navigation order. -
  7. When displayed to the students, the answers are always shuffled. That is, the - first answer from the teacher's point of view will not necessarily be the - first answer in the list shown to the students. (Further, each time the same - set of answers is displayed they are likely to appear in a different order.) +
  8. When displayed to the students, the answers are usually shuffled. That is, + the first answer from the teacher's point of view will not necessarily be + the first answer in the list shown to the students. (Further, each time the + same set of answers is displayed they are likely to appear in a different + order.) The exception is sets of answers for matching-type questions, here + the answers are shown in the same order as input by the teacher.
  9. The number of answers can vary from page to page. For example, it is allowed that some pages can end with a true/false question while others have questions with one correct answer and three, say, distractors. @@ -42,14 +46,54 @@ to that page may well be different for the two answers.)
  10. In the teacher's view of the lesson the correct answers have underlined Answer Labels. +
  11. Branch tables are simply pages which have a set of links to other + pages in the lesson. Typically a lesson may start with a branch table which + acts as a Table of Contents. +
  12. Each link in a branch table has two components, a description and the title + of the page to jump to. +
  13. A branch table effectively divides the lesson into a number of + branches (or sections). Each branch can contain a number of pages + (probably all related to the same topic). The end of a branch is usually + marked by an End of Branch page. This is a special page which, by + default, returns the student back to the preceeding branch table. (The + "return" jump in an End of Branch page can be changed, if + required, by editing the page.) +
  14. There can be more than one branch table in a lesson. For example, a lesson + might usefully be structured so that specialist points are sub-branches + within the main subject branches. +
  15. It is important to give students a means of ending the lesson. This might + be done by including an "End Lesson" link in the main branch + table. This jumps to the (imaginary) End of Lesson page. Another + option is for the last branch in the lesson (here "last" is used + in the logical ordering sense) to simply continue to the end of the lesson, + that is, it is not terminated by an End of Branch page. +
  16. When a lesson includes one or more branch tables it is advisable to set the + "Minimum number of Questions" parameter to some reasonable value. + This sets a lower limit on the number of pages seen when the grade is + calculated. Without this parameter a student might visit a single branch + in the lesson, answer all its questions correctly and leave the lesson + with the maximum grade. +
  17. Further, when a branch table is present a student has the opportunity of + re-visiting the same branch more than once. However, the grade is + calculated using the number of unique questions answered. So + repeatedly answering the same set of questions does not increase + the grade. (In fact, the reverse is true, it lowers the grade as the count + of the number of pages seen is used in the denominator when calculating + grades does include repeats.) In order to give students a fair idea of + their progress in the lesson, they are shown details of how many questions + they are answered correctly, number of pages seen, and their current grade + on every branch table page.
  18. The end of the lesson is reached by either jumping to that location explicitly or by jumping to the next page from the last (logical) page of the lesson. When the end of the lesson is reached, the student receives a congratulations message and is - shown their grade. The grade is (the number of correct answers checked / number of + shown their grade. The grade is (the number of questions correctly answered / number of pages seen) * the grade of the lesson. -
  19. If the end of the lesson is not reached, when the student goes into the - lesson they are given the choice of starting at the begining or picking up the lesson - where they answered their last correct answer. -
  20. For a lesson which allow re-takes, students are allowed to re-take the lesson until - they have achieved the maximum grade. +
  21. If the end of the lesson is not reached and the student just leaves, + when the student goes into the lesson again they are given the choice of + starting at the begining or picking up the lesson where they answered their + last correct answer. +
  22. For a lesson which allow re-takes, the teacher has the choice of using the + best grade or the average of the grades as the "final" grade from + the lesson. That grade is shown on the Grades page, for example.
+ diff --git a/lang/en/help/lesson/retake.html b/lang/en/help/lesson/retake.html index a0027e69b7..cf89d35df7 100644 --- a/lang/en/help/lesson/retake.html +++ b/lang/en/help/lesson/retake.html @@ -7,10 +7,13 @@ then the students should not be allowed to re-take the lesson.

When the students are allowed to re-take the lesson, the grades shown - in the Grades page are the grades from their best attempts of the lesson. - However, the Question Analysis always uses the answers from the - first attempts of the lesson, subsequent attempts are ignored.

+ in the Grades page are either their average grade over the re-takes + or their best grade for the lesson. The next parameter determines + which of these two grading alternatives is used.

+ +

Note that the Question Analysis always uses the answers from the + first tries of the lesson, subsequent re-takes by students are ignored.

-

By default this option is Yes, meaning that students are allowed to re-take - the lesson. It is expected that only in exceptional circumstances will this - option be set to No. +

By default this option is Yes, meaning that students are allowed to + re-take the lesson. It is expected that only in exceptional circumstances + will this option be set to No.