Merge pull request #3165 from edx/markhoeber/documentation/doc-188

Initial Reorg of Setting up Course

docs/en_us/course_authors/source/building_course/course_overview_template.rst

- 
-.. _A Template For Course Overview:
-
-========================================
- A Template For Your Course Overview
-========================================
-
-  
-Replace the placeholders in the following template with your information.
-
-.. code-block:: html
-
-  <section class="about">
-    <h2>About This Course</h2>
-    <p>Include your long course description here. The long course description
-      should contain 150-400 words.</p>
-    <p>This is paragraph 2 of the long course description. Add more paragraphs
-      as needed. Make sure to enclose them in paragraph tags.</p>
-  <section>
-  <section class="prerequisites">
-    <h2>Prerequisites</h2>
-    <p>Add information about class prerequisites here.</p>
-  </section>
-  <section class="course-staff">
-    <h2>Course Staff</h2>
-    <article class="teacher">
-      <div class="teacher-image">
-        <!-- Replace the path below with the path to your faculty image. -->
-        <img src="/c4x/edX/edX101/asset/Placeholder_FacultyImage.jpg"
-          align="left" style="margin:0 20 px 0"/>
-      </div>
-      <h3>Staff Member</h3>
-      <p>Biography of instructor/staff member</p>
-    </article>
-  <article class="teacher">
-      <div class="teacher-image">
-        <img src="/c4x/edX/edX101/asset/Placeholder_FalcutyImage.jpg"/>
-      </div>
-      <h3>Staff Member Name</h3>
-      <p>Biography of instructor/staff member</p>
-    </article>
-  </section>
-  <section class="faq">
-    <section class="responses">
-      <h2>Frequently Asked Questions</h2>
-      <article class="response">
-        <h3>Do I need to buy a textbook?</h3>
-        <p>No, a free online version of Chemistry: Principles, Patterns, and
-          Applications, First Edition by Bruce Averill and Patricia Eldredge
-          will be available, though you can purchase a printed version
-          (published by FlatWorld Knowledge) if you'd like.</p>
-      </article>
-      <article class="response">
-        <h3>Question 2?</h3>
-        <p>Answer 2.</p>
-      </article>
-    </section>
-  </section>
-
-  <!--Paragraph: <p>CONTENT GOES IN HERE</p> -->
-  <!--Line break: <br/> -->
-  <!--Hyperlink: <a href="URL">LINK TEXT</a> -->
-  <!--Email hyperlink: <a href="mailto:EMAIL@ADDRESS.COM">LINK TEXT</a> -->
-  <!--Bold text: <b>TEXT</b> -->
-  <!--Italic text: <i>TEXT</i> -->

docs/en_us/course_authors/source/building_course/creating_new_course.rst

+.. _Creating a New Course:
+
+###########################
+Creating a New Course
+###########################
+
+
+*******************
+Overview
+*******************
+
+This chapter describes how to create and set up your course:
+
+* :ref:`Create a New Course`
+* :ref:`Edit Your Course`
+* :ref:`Use the Course Checklist`
+* :ref:`Add Course Team Members`
+
+You can also :ref:`Export a Course` and :ref:`Import a Course` through Studio.
+You can do this when you need to edit the course in XML.
+
+.. _Edge: http://edge.edx.org
+.. _edX.org: http://edx.org
+
+.. _Create a New Course:
+  
+*******************
+Create a New Course
+*******************
+
+#. Log in to Studio.
+#. Click **New Course**.
+#. Enter course information as needed and click **Create**.
+
+  .. image:: ../Images/new_course_info.png
+     :alt: Image of the course creation page
+
+  .. note::  Enter new course information carefully. This information becomes
+   part of the URL for your course. To change the URL after the course is
+   created, you must contact edX through the Help site
+   (http://help.edge.edx.org). Additionally, because this information becomes
+   part of your course URL, the total number of characters in the following
+   three fields must be 65 or fewer.
+
+  * For **Course Name**, enter the title of your course. For example, the name
+    may be “Sets, Maps and Symmetry Groups". Use title capitalization for the
+    course title.
+
+  * For **Organization**, enter the name of your university. Do not include
+    whitespace or special characters.
+
+  * For **Course Number**, enter both a subject abbreviation and a number. For
+    example, for public health course number 207, enter **PH207**. For math
+    course 101x, enter **Math101x**. Do not include whitespace or special
+    characters in the course number.
+
+    .. note:: If your course will be open to the world, be sure to include the
+     "x". If it is exclusively an on-campus offering, do not include the "x".*
+
+  * For **Course Run**, enter the term your course will run. Do not include
+    whitespace or special characters.
+
+    The Course Run date you enter does not affect the default **Course Start
+    Date**.  See :ref:`Set Important Dates for Your Course` for more
+    information.
+
+4. Click **Save.**
+
+You then see the empty Course Outline.
+
+.. _Edit Your Course:
+
+************************
+Edit Your Course
+************************
+When you create a new course, the course opens in Studio automatically and you
+can begin editing.
+
+If you come back to Studio later, your courses are listed on the Studio login
+page.
+
+ .. image:: ../Images/open_course.png
+  :alt: Image of the course on the Studio dashboard
+ 
+To open the course, click the course name. You go to the Course Outline. 
+
+.. _Use the Course Checklist:
+
+************************
+Use the Course Checklist
+************************
+
+You can use a Course Checklist within Studio to help you work through the tasks
+of building a course.
+
+Categories of tasks in the Course Checklist include:
+
+* Getting Started with Studio
+* Draft a Rough Course Outline
+* Explore edX's Support Tools
+* Draft Your Course About Page
+
+From the **Tools** menu, select **Checklists**.
+
+ .. image:: ../Images/checklist.png
+  :alt: Image of the course checklist
+ 
+
+As shown above for the **Add Course Team Members** task, if you hover over a
+task, a button is displayed that takes you to the page to complete that task.
+
+You can expand and collapse sections of this page as needed.
+
+You can check tasks as you complete them. Studio saves your changes
+automatically. Other course staff can see your changes.
+
+.. _Add Course Team Members:
+
+************************
+Add Course Team Members
+************************
+
+Course team members are users who help you build your course.
+
+Only a team member with Admin access can add or remove course team members, or
+grant Admin access to other team members.
+
+Other course team members can edit the course and perform all tasks except
+adding and removing other new team members and granting Admin access.
+
+.. note::  Any course team member can delete content created by other team
+ members.
+
+All course team members must be registered with Studio and have an active
+account.
+
+To add a course team member:
+
+#. Ensure you have Admin access.
+#. Ensure that the new team member has registered with Studio.
+#. From the **Settings** menu, select **Course Team**.
+#. Click **Add a New Team Member**.
+#. Enter the new team member's email address, then click **ADD USER**.
+

docs/en_us/course_authors/source/building_course/establish_grading_policy.rst

@@ -121,17 +121,22 @@ You configure the following fields for each assignment type:
   
   The general category of the assignment. This name will be visible to students.
  
-  .. note:: All assignments of a particular type count the same toward the weight of that category. As a result, a homework assignment that contains 10 problems is worth the same percentage of a student's grade as a homework assignment that contains 20 problems. 
+  .. note:: All assignments of a particular type count the same toward the
+   weight of that category. As a result, a homework assignment that contains
+   10 problems is worth the same percentage of a student's grade as a homework
+   assignment that contains 20 problems.
   
   
 * **Abbreviation:** 
   
-  This is the short name that appears next to an assignment on a student's **Progress** tab.
+  This is the short name that appears next to an assignment on a student's
+  **Progress** tab.
       
 
 * **Weight of Total Grade:** 
   
-  The assignments of this type together account for the percent value set in **Weight of Total Grade**.
+  The assignments of this type together account for the percent value set in
+  **Weight of Total Grade**.
   
   The total weight of all assignment types must equal 100.
   
@@ -141,7 +146,8 @@ You configure the following fields for each assignment type:
   
 * **Total Number:** 
   
-  The number of assignments of this type that you plan to include in your course.
+  The number of assignments of this type that you plan to include in your
+  course.
   
   
   

docs/en_us/course_authors/source/building_course/export_import_course.rst

@@ -15,8 +15,10 @@ There are several reasons you may want to export your course:
 
 * To save your work
 * To edit the XML in your course directly
-* To create a backup copy of your course, which you can import if you want to revert the course back to a previous state
-* To create a copy of your course that you can later import into another course instance and customize
+* To create a backup copy of your course, which you can import if you want to
+  revert the course back to a previous state
+* To create a copy of your course that you can later import into another course
+  instance and customize
 * To share with another instructor for another class
  
  
@@ -35,7 +37,7 @@ The following data is not exported with your course:
  
 * User data
 * Course team data
-* Forum/discussion data
+* Discussion data
 * Certificates
 
 To export a course:
@@ -54,9 +56,9 @@ Import a Course
 
 .. warning::
 
-	Content of the imported course replaces all the content of this course. 
-	**You cannot undo a course import**. We recommend that you first export the current course, 
-	so you have a backup copy of it.
+	Content of the imported course replaces all the content of this course.
+	**You cannot undo a course import**. We recommend that you first export the
+	current course, so you have a backup copy of it.
  
 There are several reasons you may want to import a course:
 
@@ -65,18 +67,20 @@ There are several reasons you may want to import a course:
 * To load a course you developed outside of Studio
 
 
-The course that you import must be in a .tar.gz file (that is, a .tar file compressed with GNU Zip). 
-This .tar.gz file must contain a course.xml file in a course data directory. The tar.gz file must
-have the same name as the course data directory. It may also contain other files.
+The course that you import must be in a .tar.gz file (that is, a .tar file
+compressed with GNU Zip). This .tar.gz file must contain a course.xml file in a
+course data directory. The tar.gz file must have the same name as the course
+data directory. It may also contain other files.
  
-If your course uses legacy layout structures, you may not be able to edit
-the course in Studio, although it will probably appear correctly on Edge. To
-make sure that your course is completely editable, ensure that all of your
-material is embedded in a unit.
+If your course uses legacy layout structures, you may not be able to edit the
+course in Studio, although it will probably appear correctly on Edge. To make
+sure that your course is completely editable, ensure that all of your material
+is embedded in a unit.
  
-The import process has five stages. During the first two stages, you must stay on the Course Import page. 
-You can leave this page after the Unpacking stage has completed. We recommend, however, 
-that you don't make important changes to your course until the import operation has completed. 
+The import process has five stages. During the first two stages, you must stay
+on the Course Import page. You can leave this page after the Unpacking stage has
+completed. We recommend, however, that you don't make important changes to your
+course until the import operation has completed.
  
 To import a course:
  

docs/en_us/course_authors/source/building_course/index.rst

@@ -7,9 +7,7 @@ Building a Course
 .. toctree::
    :maxdepth: 2
 
-   create_new_course
-   establish_grading_policy
-   organizing_course
+   creating_new_course
    export_import_course
-   course_overview_template
-   dynamic_html_schedule
+   setting_up_student_view
+   establish_grading_policy
\ No newline at end of file

docs/en_us/course_authors/source/change_log.rst

@@ -10,18 +10,29 @@ Change Log
 
    * - Date
      - Change  
+   * - 04/02/14
+     - Reorganized the sections :ref:`Building a Course Index` and
+       :ref:`Creating Course Content Index` to better reflect the workflow of
+       building a new course.
    * - 04/01/14 
-     - Update the :ref:`Establish a Grading Policy` chapter to emphasize that grading is applied to subsections only.   
+     - Update the :ref:`Establish a Grading Policy` chapter to emphasize that
+       grading is applied to subsections only.
    * - 
-     - Updated the :ref:`Releasing Your Course Index` section to include :ref:`Launch`.
+     - Updated the :ref:`Releasing Your Course Index` section to include
+       :ref:`Launch`.
    * - 03/31/14 
-     - Expanded the :ref:`Grades` chapter to include the new :ref:`Review_Answers` section.
+     - Expanded the :ref:`Grades` chapter to include the new
+       :ref:`Review_Answers` section.
    * - 03/27/14
-     - Updated the :ref:`Add Pages` section to reflect feature changes.
-   * - 03/27/14
-     - Updated the section on :ref:`Beta_Testing` to include the new "batch add" feature.
-   * - 03/19/14
-     - Updated the sections on :ref:`Beta_Testing`, :ref:`Discussions`, :ref:`Grades`, and :ref:`Student Data` with changes to the new Instructor Dashboard.
+     - Updated the :ref:`Adding Pages to a Course` section to reflect feature
+       changes.
+   * - 3/27/14
+     - Updated the section on :ref:`Beta_Testing` to include the new "batch add"
+       feature.
+   * - 3/19/14
+     - Updated the sections on :ref:`Beta_Testing`, :ref:`Discussions`,
+       :ref:`Grades`, and :ref:`Student Data` with changes to the new Instructor
+       Dashboard.
    * - 03/17/14
      - Reorganized this document into major sections: 
 
@@ -53,9 +64,11 @@ Change Log
        * :ref:`Describe Your Course`
 
    * - 02/25/14
-     - Updated :ref:`Add Files to a Course` section to include new External URL feature.
+     - Updated :ref:`Add Files to a Course` section to include new External URL
+       feature.
    * -
-     - Updated :ref:`Add a Link to a File` and :ref:`Add an Image to an HTML Component` to specify you must use the file's Embed URL.
+     - Updated :ref:`Add a Link to a File` and :ref:`Add an Image to an HTML
+       Component` to specify you must use the file's Embed URL.
    * - 02/24/14
      - Created new chapter, :ref:`Getting Started with edX`.
    * -
@@ -63,42 +76,54 @@ Change Log
    * - 02/21/14
      - Added the :ref:`Beta_Testing` chapter. 
    * - 02/19/14
-     - Updated :ref:`Import LaTeX Code` to reflect new workflow and UI change for creating Latex HTML components.
+     - Updated :ref:`Import LaTeX Code` to reflect new workflow and UI change
+       for creating Latex HTML components.
    * - 02/18/14
-     - Included several enhancements to the chapter :ref:`Establish a Grading Policy`
+     - Included several enhancements to the chapter :ref:`Establish a Grading
+       Policy`
    * - 02/14/14
-     - Added :ref:`Additional Transcripts` section to :ref:`Working with Video Components`; 
-       updated :ref:`Video Advanced Options`.
+     - Added :ref:`Additional Transcripts` section to :ref:`Working with Video
+       Components`; updated :ref:`Video Advanced Options`.
    * -
-     - Added the :ref:`Course Data`, :ref:`Course_Staffing`, and :ref:`Enrollment` chapters. 
+     - Added the :ref:`Course Data`, :ref:`Course_Staffing`, and
+       :ref:`Enrollment` chapters.
    * - 02/11/14
-     - Added :ref:`Gene Explorer` and updated :ref:`Interactive Periodic Table` and :ref:`Molecule Editor` in :ref:`Additional Tools`.
+     - Added :ref:`Gene Explorer` and updated :ref:`Interactive Periodic Table`
+       and :ref:`Molecule Editor` in :ref:`Additional Tools`.
    * - 02/07/14
      - Added section on :ref:`Full Screen Image`.
    * - 02/06/14
-     - Added :ref:`Interactive Periodic Table` and :ref:`Molecule Editor` to :ref:`Additional Tools`
+     - Added :ref:`Interactive Periodic Table` and :ref:`Molecule Editor` to
+       :ref:`Additional Tools`
    * - 02/05/14
      - Added section :ref:`Set the Advertised Start Date`.
    * - 02/04/14
      - Added the :ref:`Student Data` and :ref:`Grades` chapters.
    * - 
-     - Added :ref:`Additional Tools` topic with :ref:`Multiple Choice and Numerical Input` and :ref:`Protein Builder`.
+     - Added :ref:`Additional Tools` topic with :ref:`Multiple Choice and
+       Numerical Input` and :ref:`Protein Builder`.
    * - 01/29/2014
      - Added the chapter :ref:`Using an Instant Hangout in Your Course`.
    * - 01/24/2014
-     - Added the :ref:`Discussions` and :ref:`Guidance for Discussion Moderators` chapters.
+     - Added the :ref:`Discussions` and :ref:`Guidance for Discussion
+       Moderators` chapters.
    * - 
      - Added more detailed instructions to :ref:`Zooming image`
    * - 01/21/2014
-     - Added information about accessibility in the topic :ref:`Add Textbooks`.
+     - Added information about accessibility in the topic :ref:`Adding
+       Textbooks`.
    * - 01/14/2014
-     - Added info about scoring (:ref:`Access Scores`) and due dates in :ref:`Open Response Assessment Problems`.
+     - Added info about scoring (:ref:`ORA Access Scores`) and due dates in
+       :ref:`Open Response Assessment Problems`.
    * - 01/13/2014
-     - Extensive updates to :ref:`Organizing Your Course Content` and :ref:`Working with HTML Components`.
+     - Extensive updates to :ref:`Organizing Your Course Content` and
+       :ref:`Working with HTML Components`.
    * - 01/08/2014
-     - Updated :ref:`Add Files to a Course` to reflect addition of sorting to the **Files & Uploads** page.
+     - Updated :ref:`Add Files to a Course` to reflect addition of sorting to
+       the **Files & Uploads** page.
    * - 
-     - Updated :ref:`Set Important Dates for Your Course` to reflect change to default course start date to 2029.
+     - Updated :ref:`Set Important Dates for Your Course` to reflect change to
+       default course start date to 2029.
    * - 01/07/2014
      - Updated :ref:`Text Input` with info about multiple strings.
    * - 
@@ -108,15 +133,20 @@ Change Log
    * - 01/06/2014
      - Created :ref:`Zooming image`
    * - 01/01/2014
-     - Updated the chapters :ref:`Organizing Your Course Content` and :ref:`Testing Your Course` to reflect changes in the Course Outline design.
+     - Updated the chapters :ref:`Organizing Your Course Content` and
+       :ref:`Testing Your Course` to reflect changes in the Course Outline
+       design.
    * - 
-     - Updated the topic :ref:`Add Files to a Course` to reflect addition of pagination to the Files & Uploads page.
+     - Updated the topic :ref:`Add Files to a Course` to reflect addition of
+       pagination to the Files & Uploads page.
    * - 12/20/2013
-     - Made :ref:`ORA for Students` into template that instructors can customize.
+     - Made :ref:`ORA for Students` into template that instructors can
+       customize.
    * - 12/19/2013
      - Created :ref:`Tools`.
    * - 12/18/2013
-     - Updated documentation about video player options in :ref:`Working with Video Components`.
+     - Updated documentation about video player options in :ref:`Working with
+       Video Components`.
    * - 12/13/2013
      - Created :ref:`LTI Component`.
    * - 
@@ -126,10 +156,12 @@ Change Log
    * - 12/11/2013
      - Added the chapter :ref:`Guidelines for Creating Accessible Content`.
    * - 12/10/2013
-     - Added note about number of responses in "Available to Grade" column in :ref:`Open Response Assessment Problems`.
+     - Added note about number of responses in "Available to Grade" column in
+       :ref:`Open Response Assessment Problems`.
    * - 
      - Added :ref:`MathJax in Studio`.
    * - 12/09/2013
      - Created :ref:`MathJax in Studio`.
    * - 12/05/2013
-     - Complete revision of edX Studio documentation and integration of edX101 content.
+     - Complete revision of edX Studio documentation and integration of edX101
+       content.

docs/en_us/course_authors/source/creating_content/course_files.rst

+.. _Add Files to a Course:
+
+###########################
+Adding Files to a Course
+###########################
+
+
+*******************
+Overview
+*******************
+
+To use images in your course content, or to use other documents such as a
+syllabus, you must add the files to your course.
+
+* :ref:`Add a File`
+* :ref:`File URLs`
+* :ref:`Sort Files`
+* :ref:`Find Files`
+* :ref:`Lock a File`
+* :ref:`Delete a File`
+
+
+.. _Add a File:
+
+*******************
+Add a File
+*******************
+ 
+You can add files that you want students to access in the course. After you add
+a file, you must link to it from a component, a course update, or in the course
+handouts. A file is only visible to students if you create a link to it.
+
+.. note:: Because the file name becomes part of the URL, students can see the
+ name of the file when they open it. Avoid using file names such as
+ AnswerKey.pdf.
+  
+.. warning:: If you upload a file with the same name as an existing course file,
+ the original file is overwritten without warning.
+
+To add files:
+ 
+#. From the **Content** menu, select **Files & Uploads**.
+#. Click **Upload New File**.
+#. In the **Upload New File** dialog box, click **Choose File**.
+#. In the **Open** dialog box, select one more files that you want to upload,
+   then click **Open**.
+#. To add more file, click **Load Another File** and repeat the previous step.
+#. To close the dialog box, click the **x** in the top right corner. 
+
+When you close the dialog box, the new files appear on the **Files & Uploads**
+page.
+
+.. _File URLs:
+
+*******************
+File URLs
+*******************
+
+In the Files & Uploads page, each file has has an **Embed URL** and an
+**External URL**:
+
+
+.. image:: ../Images/files_uploads_urls.png
+ :alt: Image of the Files and Uploads page, with Embed URL and External URL
+     columns circled
+
+* You use the **Embed URL** to link to the file or image from a component, a
+  course update, or a course handout.
+
+* You use the **External URL** to reference the file or image from outside of
+  your course. The external URL does not work if you lock the file unless the
+  person accessing the URL is enrolled in the course.
+
+  .. warning:: You cannot use the External URL as the reference to a file or
+   image from within your course.
+
+You can double click a value in the **Embed URL** or **External URL** column to select the value, then copy it.
+
+.. _Sort Files:
+
+*******************
+Sort Files
+*******************
+
+By default, files are sorted by the **Date Added** column, with the most
+recently added first.
+
+Alternatively, can also sort the list by the **Name** column by clicking on the
+column header.
+
+For either the the **Date Added** or **Name** column, you can switch the sort
+order from descending to ascending, and back, by clicking the column header a
+second time.
+
+The current sort order is shown at the top of the file list, and the active sort
+column header is underlined:
+
+.. image:: ../Images/file_sort.png
+  :alt: Sorting files in the Files & Uploads page
+
+.. _Find Files:
+
+*******************
+Find Files
+*******************
+
+The **Files & Uploads** page lists up to 50 files.  If your course has more than
+50 files, additional files are listed on other pages.
+
+The range of the files listed on the page, and the total number of files, are
+shown at the top of the page.
+
+You can navigate through the pages listing files in two ways:
+
+* Use the **<** and **>** buttons at the top and bottom of the list to navigate
+  to the previous and next pages.
+
+* At the bottom of the page, enter the page number to skip to, then tab out of
+  the field:
+
+  
+  .. image:: ../Images/file_pagination.png
+    :alt: Pagination in the Files & Uploads page
+
+.. _Lock a File:
+ 
+*******************
+Lock a File
+*******************
+
+By default, anyone can access a file you upload if they know the URL, even
+people not enrolled in your class.
+
+To ensure that those not in your class cannot view the file, click the lock
+icon.
+
+.. note:: The external URL does not work if you lock the file.
+ 
+.. _Delete a File:
+
+*******************
+Delete a File
+*******************
+
+To delete a file, click the **x** icon next to the file.  You are prompted to
+confirm the deletion.
+
+.. warning:: If you have links to a file you delete, those links will be broken.
+ Ensure you change those links before deleting the file.
+ 
\ No newline at end of file

docs/en_us/course_authors/source/creating_content/create_discussion.rst

@@ -8,7 +8,7 @@ Working with Discussion Components
 Overview
 *******************
 
-You can add a Discussion component to a Unit, to pose a question related to the
+You can add a Discussion component to a unit, to pose a question related to the
 Unit and give students a chance to respond and interact.
 
 See the following topics:
@@ -39,8 +39,8 @@ Create a Discussion Component
  Discussion component is set to Private.
 
 
-To create a new Discussion component in an existing Unit, ensure the Unit is
-Private. For more information on Public and Private Units, see :ref:`Public and
+To create a new Discussion component in an existing unit, ensure the unit is
+Private. For more information, see :ref:`Public and
 Private Units`.
 
 #. Under **Add New Component**, click the **discussion** icon.

docs/en_us/course_authors/source/creating_content/handouts_updates.rst

+.. _Adding Course Updates and Handouts:
+
+######################################################
+Adding Course Updates and Handouts
+######################################################
+
+You add course updates and handouts in Studio.
+
+Student's see the course updates and handouts in the **Course Info** tab in your
+course:
+
+.. image:: ../Images/course_info.png
+ :alt: Image of the Course Info page.
+
+.. _Add a Course Update:
+
+**********************
+Add a Course Update
+**********************
+
+You add updates to notify students of exams, changes in the course schedule, or
+anything else of a more urgent nature.
+
+To add a course update:
+
+#. From the **Content** menu, select **Updates**. 
+#. Click **New Update**.
+#. Enter your update in the HTML editor that opens.
+
+  .. note::  You must enter the update in HTML. 
+
+4. Click **Save**.
+
+.. _Add Course Handouts:
+
+**********************
+Add Course Handouts
+**********************
+You can add course handouts that are visible to students on the **Course Info**
+page. To add an uploaded file to the course handouts, you will need its URL.
+
+.. note::  You must :ref:`Add Files to a Course` before you can add them as
+ course handouts.
+
+#. From the **Content** menu, select **Updates**. 
+#. In the **Course Handouts** panel, click **Edit**.
+#. Edit the HTML to add links to the files you uploaded. See :ref:`Add a Link in
+   an HTML Component` for more information.
+#. Click **Save**.
+

docs/en_us/course_authors/source/creating_content/index.rst

@@ -9,6 +9,11 @@ Creating Course Content
    :maxdepth: 2
    
    accessibility
+   course_files
+   handouts_updates
+   textbooks
+   pages
+   organizing_course
    create_html_component
    create_video
    create_discussion

docs/en_us/course_authors/source/building_course/dynamic_html_schedule.rst → docs/en_us/course_authors/source/creating_content/pages.rst

-     
-.. _Appendix B:
+.. _Adding Pages to a Course:
 
-===========================================
+###########################
+Adding Pages to a Course
+###########################
+
+
+*******************
+Overview
+*******************
+
+By default, your course has the following pages:
+
+* Courseware
+* Course Info
+* Discussion
+* Wiki
+* Progress
+
+You cannot rename, reorder, or remove these pages.
+
+You can add pages to your course. Each page appears in your course's navigation bar. 
+
+For example, the following navigation bar includes the default pages as well as the
+**Course Schedule** and **Supplements & Instructor's Blog** pages.
+
+.. image:: ../Images/page_bar_lms.png
+ :alt: Image of the page bar in the LMS
+
+You can create other pages for the grading policy, course slides, or any other purpose. More examples of pages you can add are:
+
+* A Google calendar, by embedding the code for it.  
+
+* A dynamic HTML calendar, using the template in :ref:`Code for Dynamic HTML Schedule`.
+
+* An instant hangout.  See :ref:`Using an Instant Hangout in Your Course` for more information.
+
+See:
+
+* :ref:`Add a Page`
+* :ref:`Reorder Pages`
+* :ref:`Delete a Page`
+* :ref:`Code for Dynamic HTML Schedule`
+
+
+.. _`Add a Page`:
+
+****************
+Add a Page
+****************
+
+#. In Studio, from the **Content** menu, select **Pages**. 
+
+  .. image:: ../Images/pages_page.png
+   :alt: Image of the Pages screen
+
+
+2. Click **Add a New Page**. A page with the title **Empty** is added to the list:
+
+  .. image:: ../Images/pages_empty.png
+   :alt: Image of the Pages screen with a new Empty page
+
+3. Click **Edit**. The HTML editor opens.  
+
+  .. image:: ../Images/pages_editor.png
+   :alt: Image of the Page editor
+
+4. Enter text for your page. See :ref:`The User Interface` for more information about using the editor.
+#. Click **Settings** to edit the **Display Name**. The display name is the name of the page visible to students in the course.
+#. Click **Save**. 
+
+The new page is immediately available to students, if the course has started.
+
+.. _Reorder Pages:
+
+****************
+Reorder Pages
+****************
+
+You can reorder pages in your course by dragging and dropping the pages to different locations. 
+
+To move a page, hover over the element handle on the right side of the page row until the mouse pointer changes to a four-headed arrow. Then, click and drag the page to the location that you want.
+
+.. note:: You cannot reorder the Courseware, Course Info, Discussion, Wiki, and Progress pages that your course includes by default
+
+.. _Delete a Page:
+
+****************
+Delete a Page
+****************
+
+To delete a page that you previously added, click the trash can icon in the row for the page.  You are prompted to confirm the deletion.
+
+.. _Code for Dynamic HTML Schedule:
+
+********************************
 Code for Dynamic HTML Schedule
-===========================================
+********************************
+
+You can use the following code in a page to provide a dynamic HTML schedule in your course.
 
 .. code-block:: html
 

docs/en_us/course_authors/source/creating_content/textbooks.rst

+.. _Adding Textbooks:
+
+###########################
+Adding Textbooks
+###########################
+
+You can add PDF textbooks for your course.  
+
+.. note::  Do not use image files (for example, .PNG files) as textbooks for
+ your course, as they are not accessible to screen readers. Review the
+ :ref:`Best Practices for Accessible PDFs` for more information.
+
+Each textbook that you add is displayed to students as a tab in the course
+navigation bar.
+
+It's recommended that you upload a separate PDF file for each chapter of your
+textbook.
+
+When students open the textbook tab in the course, they can navigate the
+textbook by chapter:
+
+.. image:: ../Images/textbook_chapters.png
+ :alt: Image of a textbook in a course.
+
+To add a textbook:
+
+#. From the **Content** menu, select **Textbooks**.
+#. Click **New Textbook**. The following screen opens:
+
+  .. image:: ../Images/textbook_new.png
+   :alt: Image of the New Textbook page.
+
+3. Enter the **Textbook Name**.
+#. Enter the first **Chapter Name**.
+#. To upload a PDF file from your computer, click **Upload PDF**.  Follow the
+   prompts to upload your file.
+#. To add more chapters, click **+Add a Chapter** and repeat steps 3 and 4.
+#. Click **Save**.
\ No newline at end of file

docs/en_us/course_authors/source/getting_started/glossary.rst

@@ -16,7 +16,7 @@ A
 
   The course page that provides potential students with a course summary, prerequisites, a course video and image, and important dates.
 
-  See :ref:`Setting up a New Course` for more information.
+  See :ref:`The Course Summary Page` for more information.
 
 .. _Advanced Editor-g:
  
@@ -231,7 +231,7 @@ G
  
   List of the items that a student's response should cover in an open response assessment.
 
-  See :ref:`Rubrics` for more information.
+  See :ref:`ORA Rubrics` for more information.
 
 
 .. _H:
@@ -383,7 +383,7 @@ P
 
   Pages that supplement the courseware for a course. Each page appears in your course's navigation bar. 
 
-  See :ref:`Add Pages` for more information.
+  See :ref:`Adding Pages to a Course` for more information.
 
 .. _Preview Mode:
  
@@ -443,7 +443,7 @@ R
 
   List of the items that a student's response should cover in an open response assessment.
 
-  See :ref:`Rubrics` for more information.
+  See :ref:`ORA Rubrics` for more information.
 
 
 

docs/en_us/course_authors/source/problems_tools/google_hangouts.rst

@@ -38,7 +38,7 @@ Instant Hangouts in Your Course
 
 You can add one or more instant hangouts in your course. For example, you can add an instant hangout:
 
-* In a page, to provide students with a hangout for the entire course. See :ref:`Add Pages` for more information.
+* In a page, to provide students with a hangout for the entire course. See :ref:`Adding Pages to a Course` for more information.
 
 * In an HTML component, to provide a hangout for students working on that specific course unit. See :ref:`Working with HTML Components` for more information about creating HTML components.
 

docs/en_us/course_authors/source/students/ora_students.rst

@@ -58,7 +58,7 @@ see :ref:`ORA Self Assessment`, :ref:`ORA Peer Assessment`, and :ref:`ORA AI Ass
 
 After you submit your response, your score will be available shortly - sometimes within a few
 minutes. For information about how to access your score after your response has been graded,
-see :ref:`ORA Access Scores`.
+see :ref:`ORA Access Scores Students`.
 
 If you want to experiment with open response assessments, you can try out the open
 assessment problems in the `EdX Demo <https://courses.edx.org/courses/edX/DemoX/Demo_Course/info>`_
@@ -291,7 +291,7 @@ student who submitted the response.
    .. image:: ../Images/DoneGrading.png
 
    When you see this message, you can access the score for your own
-   response. For more information, see :ref:`ORA Access Scores`.
+   response. For more information, see :ref:`ORA Access Scores Students`.
 
 If you want to grade additional responses at any time, you can go back
 to the **Peer Grading** page and click the name of the problem that you want
@@ -339,9 +339,9 @@ responses, you may receive your grade within minutes, or you may have to wait
 a few days. You won't receive a notification when your score is ready, so keep
 checking back.
 
-For more information about accessing your scores, see :ref:`ORA Access Scores`.
+For more information about accessing your scores, see :ref:`ORA Access Scores Students`.
 
-.. _ORA Access Scores:
+.. _ORA Access Scores Students:
 
 Access Scores and Feedback
 --------------------------