QA checkpoint

2013-07-01 14:51:31 -04:00
parent 6bcd11fbfb
commit a982eba10a
24 changed files with 314 additions and 206 deletions
--- a/userdocs/source/appendices/a.rst
+++ b/userdocs/source/appendices/a.rst
@@ -1,3 +1,7 @@
+.. raw:: latex
+  
+      \newpage %
+
 ========================================
 APPENDIX A-Template For Course Overview
 ========================================
--- a/userdocs/source/appendices/b.rst
+++ b/userdocs/source/appendices/b.rst
@@ -1,3 +1,8 @@
+.. raw:: latex
+  
+      \newpage %
+      
+
 ===========================================
 APPENDIX B: Code for Dynamic HTML Schedule
 ===========================================
--- a/userdocs/source/appendices/c.rst
+++ b/userdocs/source/appendices/c.rst
@@ -1,50 +1,76 @@
+.. raw:: latex
+  
+      \newpage %
+
+
 ======================================
 APPENDIX C: Sample Student Login Guide 
 ======================================

 Create a login guide for your individual course.

-    **STUDENT LOGIN GUIDE FOR [COURSE NUMBER]**
-    
-
-    How to Set Up Your edX Account and Register for Your Class
+**STUDENT LOGIN GUIDE FOR [COURSE NUMBER]**


-    Welcome to [COURSE NAME] on edX!
-    This guide will walk you through setting up your student account with edX, registering for [COURSE NAME], and accessing the course materials.
+How to Set Up Your edX Account and Register for Your Class

-    **Step 1: Open the course registration page**
-    Go to https://edge.edx.org/courses/[YOUR_CLASS_PATH]/about [REPLACE WITH URL TO YOUR REGISTRATION PAGE ON EDGE]
-    The above URL should bring you to the course registration page: [REPLACE WITH SCREENSHOT OF YOUR REGISTRATION PAGE]
+Welcome to [COURSE NAME] on edX!
+This guide will walk you through setting up your student account with edX, registering for [COURSE NAME], and accessing the course materials.
+
+**Step 1: Open the course registration page**
+
+*Example*
+
+.. code-block:: html


-    **Step 2: Request to register for the course**
-    Click on the blue Register for [NUMBER OF YOUR CLASS] button:
-    [REPLACE WITH PART OF YOUR SCREENSHOT ABOVE]
+    https://edge.edx.org/courses/[YOUR_CLASS_PATH]/about [REPLACE WITH URL TO YOUR REGISTRATION PAGE ON EDGE]

-    A pop-up user authentication window will appear. It will ask you to log in or sign up for edX. (If you already have an account with edX, use it to log in. You should now be registered for the course. Skip to Step 5. Otherwise, go on with Step 3.)
+    https://edge.edx.org/courses/edX/PHOTO101/Digital_SLR_Photography_101/about


-    **Step 3: Create your account with edX**
+The above URL should bring you to the course registration page: [REPLACE WITH SCREENSHOT OF YOUR REGISTRATION PAGE]

-    Fill out the form in the pop-up window: (Some tips:  Use an email address you check regularly. Also, the username you choose will also be your screen name in the course. This means the only name we will know you by is the username (not a first and last name). Please include your last name as part of your username so we can tell who you are on the forums.)
+*Example*
+
+.. image:: ../images/image302.png
+ :width: 600 


-    **Step 4: Activate your edX account**

-    Check your email. This is where your course activation link has been sent. You must click on this to finalize your access to the course.
+**Step 2: Request to register for the course**
+Click on the blue Register for [NUMBER OF YOUR CLASS] button:
+[REPLACE WITH PART OF YOUR SCREENSHOT ABOVE]

-    Congratulations! You should now have an edX account and be registered for [ENTER YOUR COURSE NUMBER].
+.. image:: ../images/image303.png
+ :width: 600 

-    Proceed with Step 5 to access the class materials.
+A pop-up user authentication window will appear. It will ask you to log in or sign up for edX. (If you already have an account with edX, use it to log in. You should now be registered for the course. Skip to Step 5. Otherwise, go on with Step 3.)
+
+.. image:: ../images/image305.png
+ :width: 600 


-    **Step 5: Log in to edX and go the course website**
+**Step 3: Create your account with edX**

-    Log in to your account on edX at https://edge.edx.org/
-    by using the username and password you just created.
-    You will be taken to the main landing page of your edX edge account, which should now include a listing for [ENTER YOUR COURSE NUMBER]: [REPLACE WITH SCREENSHOT OF YOUR COURSE]
+Fill out the form in the pop-up window: (Some tips:  Use an email address you check regularly. Also, the username you choose will also be your screen name in the course. This means the only name we will know you by is the username (not a first and last name). Please include your last name as part of your username so we can tell who you are on the forums.)

-    You can now click **View Courseware** to enter the main course website. 

-    If you are experiencing problems with registration or with accessing the class website, please contact [SUPPORT CONTACT NAME] at [CLASS SUPPORT EMAIL].
+**Step 4: Activate your edX account**
+
+Check your email. This is where your course activation link has been sent. You must click on this to finalize your access to the course.
+
+Congratulations! You should now have an edX account and be registered for [ENTER YOUR COURSE NUMBER].
+
+Proceed with Step 5 to access the class materials.
+
+
+**Step 5: Log in to edX and go the course website**
+
+Log in to your account on edX at https://edge.edx.org/
+by using the username and password you just created.
+You will be taken to the main landing page of your edX edge account, which should now include a listing for [ENTER YOUR COURSE NUMBER]: [REPLACE WITH SCREENSHOT OF YOUR COURSE]
+
+You can now click **View Courseware** to enter the main course website. 
+
+If you are experiencing problems with registration or with accessing the class website, please contact [SUPPORT CONTACT NAME] at [CLASS SUPPORT EMAIL].
--- a/userdocs/source/appendices/d.rst
+++ b/userdocs/source/appendices/d.rst
@@ -1,3 +1,8 @@
+.. raw:: latex
+  
+      \newpage %
+      
+
 ======================
 APPENDIX D: Time Zones
 ======================
--- a/userdocs/source/appendices/e.rst
+++ b/userdocs/source/appendices/e.rst
@@ -1,3 +1,8 @@
+.. raw:: latex
+  
+      \newpage %
+
+
 ==========================
 APPENDIX E: Problem Types
 ==========================
@@ -11,20 +16,14 @@ answer options, presented as a drop-down list.
 Option Response is structurally similar to Multiple Choice. Some conceptual
 differences between the two include the following.

-• The Multiple Choice radio button format makes it easier for students to read
-• very long response options.
+* The Multiple Choice radio button format makes it easier for students to read very long response options.

-• The Option Response drop-down input format makes it more likely for students
-to think of an answer and then search for it, rather than relying purely on
-recognition to answer the question. The Multiple Choice format is more explicit
-and visual. This makes it a more appropriate choice for presenting tricky or
-complicated answer options which are intended to get the student to pause and
-think.
+* The Option Response drop-down input format makes it more likely for students to think of an answer and then search for it, rather than relying purely on recognition to answer the question. The Multiple Choice format is more explicit and visual. This makes it a more appropriate choice for presenting tricky or complicated answer options which are intended to get the student to pause and think.

 Sample Problem:

 .. image:: ../images/image287.png
- :width: 600  
+    :width: 600  

 **Problem Code:**

@@ -39,7 +38,7 @@ Sample Problem:
       options="('Multiple Choice','String Response',
                'Numerical Response','External Response',
                'Image Response')"
-      correct="Multiple Choice"/>
+      correct="Multiple Choice"/>1
    </optionresponse>

   <solution>
@@ -78,12 +77,17 @@ Sample Problem:
 <optionresponse>


-.. image:: ../images/option_response1.png
+  .. image:: ../images/option_response1.png


 <optioninput>

-.. image:: ../images/optionresponse2.png
+  .. image:: ../images/optionresponse2.png
+
+
+.. raw:: latex
+  
+      \newpage %


 Multiple Choice 
@@ -100,16 +104,13 @@ marked as incorrect, there is no correct response.
 Multiple Choice is structurally similar to Option Response. Some conceptual
 differences between the two include the following.

-• The Multiple Choice radio button format makes it easier for students to read
-• very long response options.
+• The Multiple Choice radio button format makes it easier for students to read very long response options.

-• The Option Response drop-down input format makes it more likely for students
-• to think of an answer and then search for it, rather than relying purely on
-• recognition to answer the question.
+• The Option Response drop-down input format makes it more likely for students to think of an answer and then search for it, rather than relying purely on recognition to answer the question.

-• The Multiple Choice format is more explicit and visual. This makes it a more
-appropriate choice for presenting tricky or complicated answer options which are
-intended to get the student to pause and think. Sample Problem:
+• The Multiple Choice format is more explicit and visual. This makes it a more appropriate choice for presenting tricky or complicated answer options which areintended to get the student to pause and think. 
+
+Sample Problem:

 .. image:: ../images/image289.png
 :width: 600  
@@ -173,12 +174,17 @@ intended to get the student to pause and think. Sample Problem:

 <choicegroup>

-.. image:: ../images/multipleresponse2.png
+  .. image:: ../images/multipleresponse2.png


 <choice>

-.. image:: ../images/multipleresponse3.png
+  .. image:: ../images/multipleresponse3.png
+
+
+.. raw:: latex
+  
+      \newpage %


 Checkbox
@@ -235,6 +241,10 @@ Sample Problem:
  </choiceresponse>
  </problem>

+.. raw:: latex
+  
+     \newpage %
+

 String Response
 ===============
@@ -293,12 +303,16 @@ Sample Problem:

 <stringresponse>

-
-.. image:: ../images/stringresponse.png
+  .. image:: ../images/stringresponse.png

 <textline>

-.. image:: ../images/stringresponse2.png
+  .. image:: ../images/stringresponse2.png
+
+
+.. raw:: latex
+  
+      \newpage %


 Numerical Response
@@ -469,20 +483,25 @@ XML Attribute Information

 <script>

-.. image:: ../images/numericalresponse.png
+  .. image:: ../images/numericalresponse.png

 <numericalresponse>


-.. image:: ../images/numericalresponse2.png
+  .. image:: ../images/numericalresponse2.png

 <responseparam>

-.. image:: ../images/numericalresponse4.png
+  .. image:: ../images/numericalresponse4.png

 <textline>

-.. image:: ../images/numericalresponse5.png
+  .. image:: ../images/numericalresponse5.png
+
+
+.. raw:: latex
+  
+      \newpage %



@@ -573,18 +592,23 @@ XML Attribute Information
 <script>


-.. image:: ../images/formularesponse.png
+  .. image:: ../images/formularesponse.png


 <formularesponse>


-.. image:: ../images/formularesponse3.png
+  .. image:: ../images/formularesponse3.png

 <responseparam>


-.. image:: ../images/formularesponse6.png
+  .. image:: ../images/formularesponse6.png
+
+
+.. raw:: latex
+  
+      \newpage %


 Image Response
@@ -626,11 +650,15 @@ XML Attribute Information

 <imageresponse>

-.. image:: ../images/imageresponse1.png
+  .. image:: ../images/imageresponse1.png

 <imageinput>

-.. image:: ../images/imageresponse2.png
+  .. image:: ../images/imageresponse2.png
+
+.. raw:: latex
+  
+      \newpage %


 Custom Response
@@ -755,6 +783,11 @@ Sample Problem:
      </solution>
  </problem>

+
+.. raw:: latex
+  
+      \newpage %
+
 Chemical Equation Response
 ==========================

@@ -792,6 +825,11 @@ Sample Problem:
    <endouttext/>
  </problem> 

+h
+.. raw:: latex
+  
+      \newpage %
+
 Schematic Response
 ==================