added content to these

2005-03-10 23:59:21 +00:00
parent 23381eef51
commit 4b63a1cbe8
20 changed files with 145 additions and 46 deletions
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Slide Show Background Color</b></p>
+
+<p>Type in a 6 letter code for the color of the slides.</p>
@@ -1 +1,6 @@
-Under Construction
+<p align="center"><b>Custom Scoring</b></p>
+
+<p>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.</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Delete student attempts for this lesson (user id)</b></p>
+
+<p>Type a username in here and click "Save Changes" to delete all attempts and grades for that user.</p>
@@ -1 +1,5 @@
-Under Construction
+<p align="center"><b>Display Left Menu</b></p>
+
+<p>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).</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Slide Show Height</b></p>
+
+<p>Type a number for how many pixels high the slides will be.</p>
@@ -1 +1,5 @@
-Under Construction
+<p align="center"><b>Display High Scores</b></p>
+
+<p>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.</p>
@@ -1,6 +1,7 @@
 <p align="center"><b>The Jump-to Link</b></p>

-<p>Each answer has a Jump-to link. When this answer is chosen, the answer's response
+<p>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 <b>This
    page</b> and <b>Next page</b>. <b>This page</b> means that the student sees the
@@ -10,4 +11,19 @@
 <p>Note that a (relative) <b>Next page</b> Jump-to link may show a different page
    after pages have been moved. Whereas Jump-to links which use page <b>titles</b>
    always show the same page after pages have been moved.</p>
+<p>Special Jumps</p>
+<p>Unseen Question within a Branch</p>
+<p>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.</p>
+
+<p>Random Question within a Branch</p>
+<p>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.</p>
+
+<p>Random Branch Table</p>
+<p>This will jump to a random Branch Table between the current Branch Table and the End
+	of Lesson or the next End of Branch.</p>

@@ -1 +1,5 @@
-Under Construction
+<p align="center"><b>Use this lesson's settings as defaults</b></p>
+
+<p>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.</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Number of High Scores Displayed</b></p>
+
+<p>Type a number to limit how many of the top scores are displayed.</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Time Limit</b></p>
+
+<p>Type a number in minutes here for the time limit.</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Allow Student Review</b></p>
+
+<p>This will let the student navigate back through the lesson to change their answers.</p>
@@ -5,15 +5,19 @@
    tables</b>.</li>
 <li>A page contains some <b>content</b> and it normally ends with a
    <b>question</b>. Thus the term <b>Question Page</b>.</li>
-<li>Each page normally has a set of <b>answers</b>. </li>
+<li>For Essay Questions, there is no answer, just a score, feedback, and a page jump.</li>
 <li>Each answer can have a short piece of text which is displayed if the answer is
    chosen. This piece of text is called the <b>response</b>.</li>
 <li>Also associated with each answer is a <b>jump</b>. 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.</li>
-<li>By default, the first answer jumps to the <b>next page</b> 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.
+<li>By default, the first answer jumps to the <b>next page</b> 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.</li>
 <li>The next page is determined by the lesson's <b>logical order</b>. This is
    the order of the pages as seen by the teacher. This order can be altered
    by moving pages within the lesson.</li>
@@ -34,12 +38,16 @@
    with one correct answer and three, say, distractors. </li>
 <li>It is possible to set up a page without any answers. The students are shown
    a <b>Continue</b> link instead of the set of shuffled answers.</li>
-<li>For the purposes of grading the lessons, <b>correct</b> answers are ones which
+<li>If custom scoring is off: for the purposes of grading the lessons, <b>correct</b> answers are ones which
    jump to a page which is further <i>down</i> the logical order than the current page.
    <b>Wrong</b> answers are ones which either jump to the same page or to a page
    further <i>up</i> the logical order than the current page. Thus, if the jumps are
    <i>not</i> changed, the first answer is a correct answer and the other answers are
-    wrong answers.</li>
+    wrong answers.
+	<br /><br />
+	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%.</li>
 <li>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 &quot;last&quot; is used
    in the logical ordering sense) to simply continue to the end of the lesson,
    that is, it is <i>not</i> terminated by an End of Branch page.</li>
-<li>When a lesson includes one or more branch tables it is advisable to set the
-    &quot;Minimum number of Questions&quot; 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.</li>
-<li>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 <i>unique</i> questions answered. So
-    repeatedly answering the same set of questions does <i>not</i> 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.</li>
+<li>With custom scoring off, when a lesson includes one or more branch tables it is
+	advisable to set the &quot;Minimum number of Questions&quot; 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.
+	<br /><br />
+	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.</li>
+<li>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 <i>unique</i> questions answered. So repeatedly answering
+	the same set of questions does <i>not</i> 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.
+	<br /> <br />
+	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.</li>
 <li>The <b>end of the lesson</b> 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.</li>
+	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).</li>
 <li>If the end of the lesson is <i>not</i> 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.</li>
-<li> For a lesson which allow re-takes, the teacher has the choice of using the
+<li>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 &quot;final&quot; grade from
    the lesson. That grade is shown on the Grades page, for example.</li>
+<li>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.</li>
 </ol>

@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Password</b></p>
+
+<p>If you have set Password Protected Lesson to "Yes", type a password here.</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Practice Lesson</b></p>
+
+<p>A practice lesson will not show up in the Gradebook.</p>
@@ -1 +1,5 @@
-Under Construction
+<p align="center"><b>Display Review Button</b></p>
+
+<p>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.</p>
@@ -1 +1,9 @@
-Under Construction
+<p align="center"><b>Slide Show</b></p>
+
+<p>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.</p>
@@ -1 +1,7 @@
-Under Construction
+<p align="center"><b>Timed</b></p>
+
+<p>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.</p>
@@ -1 +1,5 @@
-Under Construction
+<p align="center"><b>Tree View</b></p>
+
+<p>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.</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Password Protected Lesson</b></p>
+
+<p>This will not allow a student to access the lesson unless they type the password.</p>
@@ -1 +1,3 @@
-Under Construction
+<p align="center"><b>Slide Show Width</b></p>
+
+<p>Type a number for how many pixels wide the slides will be.</p>