diff --git a/lang/en/help/lesson/bgcolor.html b/lang/en/help/lesson/bgcolor.html index c8905911b6f..522ae93fc9b 100644 --- a/lang/en/help/lesson/bgcolor.html +++ b/lang/en/help/lesson/bgcolor.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

Slide Show Background Color

+ +

Type in a 6 letter code for the color of the slides.

\ No newline at end of file diff --git a/lang/en/help/lesson/custom.html b/lang/en/help/lesson/custom.html index c8905911b6f..78ccd8f29ae 100644 --- a/lang/en/help/lesson/custom.html +++ b/lang/en/help/lesson/custom.html @@ -1 +1,6 @@ -Under Construction \ No newline at end of file +

Custom Scoring

+ +

This will allow you to put a numerical point value on each answer. Answers may have +negative values or positive values. Imported questions will automatically be +assigned 1 point for correct answers and 0 for incorrect, though you may change this +after the import.

\ No newline at end of file diff --git a/lang/en/help/lesson/deleteattempts.html b/lang/en/help/lesson/deleteattempts.html index c8905911b6f..821e4a36a0e 100644 --- a/lang/en/help/lesson/deleteattempts.html +++ b/lang/en/help/lesson/deleteattempts.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

Delete student attempts for this lesson (user id)

+ +

Type a username in here and click "Save Changes" to delete all attempts and grades for that user.

\ No newline at end of file diff --git a/lang/en/help/lesson/displayleft.html b/lang/en/help/lesson/displayleft.html index c8905911b6f..ebb04caa0bb 100644 --- a/lang/en/help/lesson/displayleft.html +++ b/lang/en/help/lesson/displayleft.html @@ -1 +1,5 @@ -Under Construction \ No newline at end of file +

Display Left Menu

+ +

This will show a list of the pages (Branch Tables) in the lesson. Question pages, +cluster pages, etc. will not be shown by default (you may choose to show question +pages by checking that option on the question).

\ No newline at end of file diff --git a/lang/en/help/lesson/height.html b/lang/en/help/lesson/height.html index c8905911b6f..235cdcea9da 100644 --- a/lang/en/help/lesson/height.html +++ b/lang/en/help/lesson/height.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

Slide Show Height

+ +

Type a number for how many pixels high the slides will be.

diff --git a/lang/en/help/lesson/highscores.html b/lang/en/help/lesson/highscores.html index c8905911b6f..dcefded714b 100644 --- a/lang/en/help/lesson/highscores.html +++ b/lang/en/help/lesson/highscores.html @@ -1 +1,5 @@ -Under Construction \ No newline at end of file +

Display High Scores

+ +

A list of the high scores for the lesson will be shown. Students who get a high +score can choose a custom name to list their score by. There is a 'badwords' filter +which checks for naughty names.

\ No newline at end of file diff --git a/lang/en/help/lesson/jumpto.html b/lang/en/help/lesson/jumpto.html index bd14cb60041..0388df30522 100644 --- a/lang/en/help/lesson/jumpto.html +++ b/lang/en/help/lesson/jumpto.html @@ -1,6 +1,7 @@

The Jump-to Link

-

Each answer has a Jump-to link. When this answer is chosen, the answer's response +

Each Answer (for questions) or Description (for Branch pages) has a Jump-to link. + When this answer is chosen, the answer's response is shown to the student. After that the student sees the page given in the Jump-to link. This link can be either relative or absolute. Relative links are This page and Next page. This page means that the student sees the @@ -10,4 +11,19 @@

Note that a (relative) Next page Jump-to link may show a different page after pages have been moved. Whereas Jump-to links which use page titles always show the same page after pages have been moved.

+

Special Jumps

+

Unseen Question within a Branch

+

This will link to a randomly chosen unseen (by the student in this attempt) question + between this branch table and the End of the Lesson or the next End of Branch.

+ +

Random Question within a Branch

+

This will link to a randomly chosen question between the current branch table and + the End of Lesson or the next End of Branch. If the student has already seen the + question and attempts are greater than 1, they will get another chance to earn the + point(s) for that question. If attempts are set to 1, the question will be skipped + and another random question shown.

+ +

Random Branch Table

+

This will jump to a random Branch Table between the current Branch Table and the End + of Lesson or the next End of Branch.

diff --git a/lang/en/help/lesson/lessondefault.html b/lang/en/help/lesson/lessondefault.html index c8905911b6f..2a14821975e 100644 --- a/lang/en/help/lesson/lessondefault.html +++ b/lang/en/help/lesson/lessondefault.html @@ -1 +1,5 @@ -Under Construction \ No newline at end of file +

Use this lesson's settings as defaults

+ +

Select yes before Saving the lesson, and the settings you have chosen for this +lesson will be the default settings for the next time you create a lesson for this +course.

\ No newline at end of file diff --git a/lang/en/help/lesson/maxhighscores.html b/lang/en/help/lesson/maxhighscores.html index c8905911b6f..9e03294a3ba 100644 --- a/lang/en/help/lesson/maxhighscores.html +++ b/lang/en/help/lesson/maxhighscores.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

Number of High Scores Displayed

+ +

Type a number to limit how many of the top scores are displayed.

\ No newline at end of file diff --git a/lang/en/help/lesson/maxtime.html b/lang/en/help/lesson/maxtime.html index c8905911b6f..636d05af7d2 100644 --- a/lang/en/help/lesson/maxtime.html +++ b/lang/en/help/lesson/maxtime.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

Time Limit

+ +

Type a number in minutes here for the time limit.

\ No newline at end of file diff --git a/lang/en/help/lesson/modattempts.html b/lang/en/help/lesson/modattempts.html index c8905911b6f..c07360aa213 100644 --- a/lang/en/help/lesson/modattempts.html +++ b/lang/en/help/lesson/modattempts.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

Allow Student Review

+ +

This will let the student navigate back through the lesson to change their answers.

\ No newline at end of file diff --git a/lang/en/help/lesson/overview.html b/lang/en/help/lesson/overview.html index a4ed2dac99a..d49e9d7a933 100644 --- a/lang/en/help/lesson/overview.html +++ b/lang/en/help/lesson/overview.html @@ -5,15 +5,19 @@ tables.
  • A page contains some content and it normally ends with a question. Thus the term Question Page.
    • -
  • Each page normally has a set of answers.
    • +
  • For Essay Questions, there is no answer, just a score, feedback, and a page jump.
  • 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.
  • Also associated with each answer is a jump. The jump can be relative - this page, next page - or absolute - specifying any one of the pages in the lesson or the end of the lesson.
    • -
  • By default, the first answer jumps to the next page in the lesson. - The subsequent answers jump to the same page. That is, the student is shown - the same page of the lesson again if they do not chose the first answer. +
  • By default, the first answer jumps to the next page in the lesson. The subsequent + answers jump to the same page. That is, the student is shown the same page of the + lesson again if they do not chose the first answer. If you have already created a + cluster with an end of cluster, and the question is within it, you can also choose + to jump to an Unseen Question within the cluster. This option will not be shown if + you are not in a cluster. You can surround a set of questions with cluster and end + of cluster at any time.
  • The next page is determined by the lesson's logical order. This is the order of the pages as seen by the teacher. This order can be altered by moving pages within the lesson.
    • @@ -34,12 +38,16 @@ with one correct answer and three, say, distractors.
  • It is possible to set up a page without any answers. The students are shown a Continue link instead of the set of shuffled answers.
    • -
  • For the purposes of grading the lessons, correct answers are ones which +
  • If custom scoring is off: for the purposes of grading the lessons, correct answers are ones which jump to a page which is further down the logical order than the current page. Wrong answers are ones which either jump to the same page or to a page further up the logical order than the current page. Thus, if the jumps are not changed, the first answer is a correct answer and the other answers are - wrong answers.
    • + wrong answers. +

    + If custom scoring is on: grading of an answer is determined by the point value + of the answer, the total points earned serves as a fraction of the total point value + of the lesson, up to 100%.
  • Questions can have more than one correct answer. For example, if two of the answers jump to the next page then either answer is taken as a correct answer. (Although the same destination page is shown to the students, the responses shown on the way @@ -67,33 +75,49 @@ 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.
    • -
  • 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.
    • -
  • 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.
    • +
  • With custom scoring off, 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. +

    + With custom scoring on, a student is graded based on the number of points they have + earned as a percentage of the total points for the lesson.
    • +
  • Further, with custom scoring off, 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. +

    + With custom scoring on, a student may revisit a question if the navigation path + allows it, and re-earn the point(s) for that question, if attempts is greater than + 1. To prevent this, set attempts to 1.
  • 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 questions correctly answered / number of - pages seen) * the grade of the lesson.
    • + or by jumping to the next page from the last (logical) page of the lesson. With + custom scoring off, 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 + questions correctly answered / number of pages seen) * the grade of the lesson. + With custom scoring on, the grade is the points earned as a % of the total points + (e.g. 3 points earned for a 3 point lesson = 100% of 3 points).
  • 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 beginning or picking up the lesson where they answered their last correct answer.
    • -
  • For a lesson which allow re-takes, the teacher has the choice of using the +
  • 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.
    • +
  • Cluster pages: a cluster represents a set of questions from which one or more + may be randomly chosen. Clusters should be completed with an End of Cluster page for + best results (otherwise they treat the End of Lesson as the EOC). Questions within a + cluster are randomly selected by choosing "Random Question within a Cluster" as a + jump. Questions within a cluster may either link to the EOC to exit the cluster, or + jump to an unseen question within the cluster, or jump to any other page in the + lesson. This also enables the creation of scenarios with a random element using the + lesson module.
    • diff --git a/lang/en/help/lesson/password.html b/lang/en/help/lesson/password.html index c8905911b6f..c77133439b5 100644 --- a/lang/en/help/lesson/password.html +++ b/lang/en/help/lesson/password.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

    Password

    + +

    If you have set Password Protected Lesson to "Yes", type a password here.

    \ No newline at end of file diff --git a/lang/en/help/lesson/practice.html b/lang/en/help/lesson/practice.html index c8905911b6f..363e5d7a69a 100644 --- a/lang/en/help/lesson/practice.html +++ b/lang/en/help/lesson/practice.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

    Practice Lesson

    + +

    A practice lesson will not show up in the Gradebook.

    \ No newline at end of file diff --git a/lang/en/help/lesson/review.html b/lang/en/help/lesson/review.html index c8905911b6f..a0f9f2a23c0 100644 --- a/lang/en/help/lesson/review.html +++ b/lang/en/help/lesson/review.html @@ -1 +1,5 @@ -Under Construction \ No newline at end of file +

    Display Review Button

    + +

    This will display a button after an incorrectly answered question, allowing a +student to re-attempt it. It is not compatible with essay questions, so leave this +off if you are using essay questions.

    \ No newline at end of file diff --git a/lang/en/help/lesson/slideshow.html b/lang/en/help/lesson/slideshow.html index c8905911b6f..79f59df5956 100644 --- a/lang/en/help/lesson/slideshow.html +++ b/lang/en/help/lesson/slideshow.html @@ -1 +1,9 @@ -Under Construction \ No newline at end of file +

    Slide Show

    + +

    This enables the display of the lesson as a slide show, with a fixed width, height, +and custom background color. A CSS based scroll bar will be displayed if the width +or height of the slide is exceeded by the content of a page. Questions will 'break +out' of the slide show mode, only pages (branch tables) will be shown in a slide by +default. Buttons labeled with the lang default for "Next" and "Back" will be shown +at the far right and left of the slide if that option is chosen on the page. Other +buttons will be centered below the slide.

    \ No newline at end of file diff --git a/lang/en/help/lesson/timed.html b/lang/en/help/lesson/timed.html index c8905911b6f..a212a698c34 100644 --- a/lang/en/help/lesson/timed.html +++ b/lang/en/help/lesson/timed.html @@ -1 +1,7 @@ -Under Construction \ No newline at end of file +

    Timed

    + +

    This puts a time limit on the lesson. Students are shown a JavaScript counter and +the time is recorded in the database. Due to the inconsistent nature of JavaScript, +the timer does not evict a student from the lesson when the time is up, however a +question answered after the time limit is not counted. The time in the database is +checked each time a student submits a question.

    \ No newline at end of file diff --git a/lang/en/help/lesson/tree.html b/lang/en/help/lesson/tree.html index c8905911b6f..52ca1cdde64 100644 --- a/lang/en/help/lesson/tree.html +++ b/lang/en/help/lesson/tree.html @@ -1 +1,5 @@ -Under Construction \ No newline at end of file +

    Tree View

    + +

    This will show a list of the pages and questions in the lesson as links. Pages will +be in blue and questions in red. This is handy for navigating lessons with many +pages.

    \ No newline at end of file diff --git a/lang/en/help/lesson/usepassword.html b/lang/en/help/lesson/usepassword.html index c8905911b6f..60cb7411ae6 100644 --- a/lang/en/help/lesson/usepassword.html +++ b/lang/en/help/lesson/usepassword.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

    Password Protected Lesson

    + +

    This will not allow a student to access the lesson unless they type the password.

    \ No newline at end of file diff --git a/lang/en/help/lesson/width.html b/lang/en/help/lesson/width.html index c8905911b6f..137f82c0157 100644 --- a/lang/en/help/lesson/width.html +++ b/lang/en/help/lesson/width.html @@ -1 +1,3 @@ -Under Construction \ No newline at end of file +

    Slide Show Width

    + +

    Type a number for how many pixels wide the slides will be.

    \ No newline at end of file