Merge pull request #633 from apizer/new_update_Orientation

Upgrade setOrientation

courses.dist/modelCourse/templates/setOrientation/course_info.txt

@@ -3,9 +3,13 @@
 <p align="justify">
 
 If you haven't already done so, you should change your password to
-something other than your student ID.  To do this, click on the
-Password/Email link in the list at the far left, and follow the
-directions on that page.
+something other than your student ID or whatever your instructor
+used as your initial password.  To do this, click on the
+User Settings link under MAIN MENU in the list at the far left, 
+and follow the directions on that page. Note you can collapse and
+uncollapse the MAIN MENU by clicking on the boxed angle bracket just 
+above the boldface course name so if you don't see the MAIN MENU click 
+on the boxed angle bracket to make MAIN MENU reappear.
 
 <p align="justify">
 
@@ -14,9 +18,4 @@ in the white area at the left.  This will take you to the the first
 homework assignment, which will help you to learn how to use WeBWorK
 effectively.
 
-<p align="justify">
 
-If you wish to get a printed copy of one of your assignments, you can
-do so from this page by pressing the "Download Hardcopy" button.  You
-will be taken to a page where you can select what information to
-include in the set, and which set to download.

courses.dist/modelCourse/templates/setOrientation/prob01.pg

@@ -23,16 +23,15 @@ $PAR
 At the upper left are the navigation buttons that allow you to move
 from problem to problem.  The ${LQ}Next$RQ and ${LQ}Previous$RQ
 buttons, naturally, send you to the next and previous problems.  The
-${LQ}Prob. List$RQ button takes you back to the opening
+${LQ}Problem List$RQ button takes you back to the opening
 page for the homework set (the one that lists all the problems and
 gives the instructions for the homework set).
 $PAR
 
 The area below the navigation buttons is where $WW tells you about
 your score for the current problem.  When you have submitted your
 answers, this is where you will be given information about what
-answers you got right and wrong.  (It will be shown on a grey
-backgound to help make it stand out; you will see this later.) This
+answers you got right and wrong.  This
 area also shows you how many points a problem is worth.
 $PAR
 
@@ -49,19 +48,9 @@ information also may appear there, such as a message indicating that
 the due date is passed, or that answers are available.
 $PAR
 
-In the red panel at the left, instead of the list of homework sets, you
+In the panel at the left, instead of the list of homework sets, you
 now have a list of the problems within this assignment.  You can go to
-any problem just by clicking on it.  The checkboxes at the bottom of
-the panel are discussed in the next problem.
-$PAR
-
-In the center of the top red panel is an indication of how much time
-you have left to work on the problems for this set.  Note that this is
-computed at the moment you downloaded the problem page; if you use the
-${LQ}Back$RQ and ${LQ}Forward$RQ buttons on your browser, this does
-not reload the page, so the times will not be updated.  Reload the
-page using your browser's Reload or Refresh buttons to get the current
-time.
+any problem just by clicking on it. There is also a progress bar which gives you a visual indication of your progress on the set and, following each problem number, an icon indicating if the problem has been answered corrrectly or still needs to be worked on to get full credit.
 $PAR
 
 The buttons at the bottom of the screen, including the ${LQ}Submit

courses.dist/modelCourse/templates/setOrientation/prob02.pg

@@ -22,10 +22,12 @@ press one of these buttons.
 $PAR
 
 The ${LQ}Submit Answers$RQ button causes $WW to check your answers and
-report your score for the problem.  You can continue to work on a
+report your score for the problem.  Usually you can continue to work on a
 problem until you get it right, so don't be afraid to submit your
 answer even if you have only finished parts of the problem or are
-not sure of the correctness of your answer.  If the due date is
+not sure of the correctness of your answer.  Sometimes (e.g. for 
+multiple choice or true/false type questions) your instructor
+may limit the number of attempts allowed on a problem. At the bottom of the page you will see how many attempts you have remaining. If the due date is
 passed and the answers are available, you can click the ${LQ}Show
 Correct Answers$RQ button before pressing ${LQ}Submit$RQ.
 If you do, the correct answer(s) will be displayed in the answer area
@@ -34,45 +36,29 @@ $PAR
 
 If you have typed in a complicated answer, or are being told your
 answer is incorrect when you think it's right, you may want to use the
-${LQ}Preview Answer$RQ button.  This will ask $WW to display at the
+${LQ}Preview My Answers$RQ button.  This will ask $WW to display at the
 top of the page its interpretation of what you have entered.  This
 can be used to help spot errors in your typing, and verify that $WW
-understands your answer the way you intend it to.  (This is discussed
+understands your answer the way you intend it to. And it does not count as an attempt on the problem. (This is discussed
 further in a later problem.)
 $PAR
 
-At the bottom of the red panel at the left is a box that allows you to
+The ${LQ}User Settings$RQ link under the ${LQ}MAIN MENU$RQ at the left has a ${LQ}Change Display Options$RQ section that allows you to
 change how the problem is displayed.  The equations within the problem
-can be represented in three different ways:
+can be represented in two different ways:
 
 \{BeginParList("UL")\}
 
 $ITEM
-${LQ}images${RQ} mode is the default choice (what $WW uses unless you tell 
-it otherwise). It produces the accurate mathematical notation,
+${LQ}images${RQ} mode produces accurate mathematical notation,
 with the disadvantages of being slightly slower, and not printing well
 if you want to print out a single problem.
 $ITEMSEP
 
 $ITEM
-${LQ}formatted-text${RQ} mode produces results quickly, but more
-complicated mathematics may be difficult to read in this
-mode.  For example, some fractions and integrals are not easy to read
-in formatted-text mode.
-$ITEMSEP
-
-$ITEM
-${LQ}jsMath${RQ} mode uses a JavaScript program and Cascading Style
-Sheets (CSS) to display the mathematics.  This produces good results,
-and is particularly nice if you need to change the size of the fonts
-in your browser or wish to print out a single problem.  For best
-results, however, you should download and install some fonts that
-jsMath uses; there is a link to the fonts on the jsMath control panel,
-which you can activate using the small jsMath button that will appear
-at the lower right of the screen when you activate this mode.  The
-first problem you view using jsMath may take a little longer to
-appear, as the JavaScript program is being loaded into your browser,
-but things should run faster after that.
+${LQ}MathJax${RQ} mode is the default choice (what $WW uses unless you tell 
+it otherwise). It uses Cascading Style
+Sheets (CSS) with web fonts or SVG, instead of bitmap images or Flash, so equations scale with surrounding text at all zoom levels.  MathJax is compatible with screenreaders & provides zoom for everyone.
 
 \{EndParList("UL")\}
 $PAR
@@ -81,13 +67,12 @@ Choose whichever mode is most comfortable for you.  You can always
 select a different mode if a particular problem needs it.  Here is a
 sample of some simple mathematics, \(x^2 + 3\), and a more complicated
 expression, \(\frac{x(1-x)}{2x + 1}\).  Try changing the display mode
-by clicking the ${LQ}formatted-text$RQ or ${LQ}jsMath${RQ} radio
-button and then pressing the ${LQ}Apply Options${RQ} button to cause
-the page to be reformatted.  Then change the display mode to back to
-${LQ}images$RQ mode for the rest of the homework set.
+by clicking the ${LQ}User Settings$RQ link, selecting the  ${LQ}images${RQ} radio
+button, pressing the ${LQ}Change User Settings${RQ} button and then displaying problem 2 again.  Then change the display mode to back to
+${LQ}MathJax$RQ mode for the rest of the homework set.
 $PAR
 
-The ${LQ}Show saved answers${RQ} checkbox tells whether you
+The ${LQ}Show saved answers${RQ} checkboxes tell whether you
 want $WW to fill in the answer blanks with your previous answers or
 not.  (If you like, you can test this out on the next problem, since
 there are no answer blanks in this one.)

courses.dist/modelCourse/templates/setOrientation/prob06.pg

@@ -70,11 +70,11 @@ $PAR
 
 $ITEM
 To see how $WW is interpreting what you type, enter your answer and
-then click the ${LQ}Preview Answers$RQ button, which is next to the
+then click the ${LQ}Preview My Answers$RQ button, which is next to the
 ${LQ}Submit Answers$RQ button below.  $WW will show you what it thinks
 you entered (the preview appears in your answer area at the top of the
-page). Previewing your answer does not submit it for credit; that only
-happens when you press the ${LQ}Submit Answers$RQ button.
+page). Previewing your answer does not count as an attempt on the problem and does not submit it for credit; that only
+happens when you press the ${LQ}Submit Answers$RQ button. 
 $ITEMSEP
 
 $ITEM 
@@ -109,7 +109,7 @@ Start with the template \{student "[x${CARET}()]/[()*()]"\}.
 Start by putting in an appropriate template. This means that you 
 should begin by looking at the function and thinking about how many 
 pieces are used to construct it and how those pieces are related.
-Once you have entered your answer, try using the ${LQ}Preview$RQ button
+Once you have entered your answer, try using the ${LQ}Preview My Answers$RQ button
 to see how $WW is interpreting your answer.
 \{EndExample\}
 \{ExampleRule\}

courses.dist/modelCourse/templates/setOrientation/prob07.pg

@@ -71,7 +71,9 @@ logarithm (the logarithm with base \(10\), sometimes written
 \(\log_{10}\)).  You can also write \{student "ln(x)"\} for the
 natural logarithm of \(x\), so \{student "log(x)"\} and \{student "ln(x)"\}
 mean the same thing.  Use \{student "log10(x)"\} for the base 10
-logarithm of \(x\).
+logarithm of \(x\). Note that it is possible for your instructor to 
+change \{student "log(x)"\} to mean the common
+logarithm (the logarithm with base \(10\)) but he or she should tell you if they do that.
 $ITEMSEP
 
 $ITEM

courses.dist/modelCourse/templates/setOrientation/prob15.pg

@@ -32,7 +32,7 @@ $ITEMSEP
 
 $ITEM
 Check carefully for directions on the Problem List page. 
-You can get to this page by pressing the ${LQ}Prob. List$RQ button at the 
+You can get to this page by pressing the ${LQ}Problem List$RQ button at the 
 top of any problem page.
 $ITEMSEP
 
@@ -71,7 +71,7 @@ be doing wrong.
 $PAR
 
 To get credit for this problem, you must click the ${LQ}Submit
-Answers$RQ button. Then you can use the ${LQ}Prob. List$RQ button at
+Answers$RQ button. Then you can use the ${LQ}Problem List$RQ button at
 the top of the page to return to the problem list page.  You will see
 that the problems you have done have been labeled as correct or
 incorrect, and you can go back and do problems you skipped or couldn't

courses.dist/modelCourse/templates/setOrientation/setHeader.pg

@@ -43,17 +43,22 @@ ways to find and correct errors in your entries.
 $PAR
 
 Start by examining the features of this page.  The panels at the
-left and top help you to navigate to the different pages available in
-WeBWorK.
+left (the ${LQ}MAIN MENU${RQ}) and top help you to navigate to the different 
+pages available in WeBWorK.  Note you can collapse and
+uncollapse the ${LQ}MAIN MENU${RQ} by clicking on the boxed angle bracket just above the boldface course name so if you don't see the MAIN MENU click 
+on the boxed angle bracket to make MAIN MENU reappear.
+
 $PAR
-On the left, in the ${LQ}Main Menu${RQ} panel, you have already 
+On the left, in the ${LQ}MAIN MENU${RQ} panel, you have already 
 seen the ${LQ}Homework Sets${RQ} page,
-which lists all the homework assignments (with due dates, etc.) that have
+which lists all the homework assignments that have
 been assigned to you.  Links allow you to go to any assignment
 you want to work on.  
 $PAR
-The ${LQ}Password/Email${RQ} page lets you change your password or
-email address.  The ${LQ}Grades${RQ} page 
+The ${LQ}User Settings${RQ} page lets you change your password,
+email address and display options. Display Options gives you control 
+over how you want math equations displayed.  For example with 
+${LQ}MathJax${RQ} you can control the size of equations, have access to accessibility options, etc.  The ${LQ}Grades${RQ} page 
 shows your scores on the various assignments (but there is nothing
 much to show at this point).
 $PAR
@@ -62,11 +67,6 @@ Links to your homework assignments are also listed in the ${LQ}Sets${RQ}
 panel so you can quickly switch to another assignment.
 $PAR
 
-The ${LQ}Display Options${RQ} panel gives you control over how you want
-math equations displayed.  For example with ${LQ}MathJax${RQ} you can 
-control the size of equations, have access to accessibility options, etc.
-$PAR
-
 \{
 #The ${LQ}Report Bugs${RQ} button is for reporting bugs in the WeBWorK
 #System itself to the developers WeBWorK.  It is unlikely that
@@ -81,7 +81,8 @@ The data in the panel at the top of the page tells you where you
 are in WeBWorK's hierarchy of pages, but you can ignore that for the
 most part.  There is an additional logout button at the far right,
 however, that you will need to use when you are done using $WW (don't
-press it yet).
+press it yet).  Also to the left is the boxed angle bracket that
+collapses and uncollapses the ${LQ}MAIN MENU${RQ}.
 $PAR
 
 \{
@@ -98,10 +99,16 @@ the problems, your score is zero, but after you work on some of them,
 the number of attempts and the score will reflect the work you have
 done.
 $PAR
-Near the top is a link that allows you to download a pdf ${LQ}hardcopy${RQ}
+Near the bottom is a link that allows you to download a pdf ${LQ}hardcopy${RQ}
 version of your 
 whole assignment which you can print out.  This allows you to work on 
 the assignment without having to be connected to $WW.
+$PAR
+Also near the bottom of this and every $WW page there is an 
+${LQ}Email instructor${RQ} link that you can use to send email to your instructor.  That email, in addition to what ever you write, will 
+contain information on whatever page you are on so, e.g. if you are 
+working on a problem, your instructor will know what problem it is.
+
 $PAR
 Each problem number is a link to that problem in the homework set.
 You can click on one to get to any specific problem.  To begin the
@@ -111,6 +118,7 @@ clicking on ${LQ}Log Out${RQ}, so that no one else can gain access to
 your account.
 $PAR
 
+
 END_TEXT
 
 }