Edits to polls and problem randomization

19707d27 · Sylvia Pearce · 3bc8a41f · 19707d27 · 19707d27
Commit 19707d27 authored Feb 28, 2014 by Sylvia Pearce
Hide whitespace changes
Inline Side-by-side

Showing with 47 additions and 9 deletions

docs/en_us/course_authors/source/additional_tools.rst
+24 -7

docs/en_us/course_authors/source/create_problem_component.rst
+23 -2

No files found.
--- a/docs/en_us/course_authors/source/additional_tools.rst
+++ b/docs/en_us/course_authors/source/additional_tools.rst
@@ -398,19 +398,36 @@ You can run polls in your course so that your students can share opinions on dif

 .. image:: /Images/PollExample.png

-.. note:: Creating a poll requires you to export your course, edit it in a text editor, and then re-import your course. We recommend that you create a backup copy of your course before you create the poll. We also do not recommend that you try to edit other areas of your course while you're working in the text editor unless you have the necessary background and training. 
+.. note:: Creating a poll requires you to export your course, edit some of your course's XML files in a text editor, and then re-import your course. We recommend that you create a backup copy of your course before you create the poll. We also recommend that you only edit the files that will contain polls in the text editor if you're very familiar with editing XML. 

-==========================
+===========
 Terminology
-==========================
+===========
+
+Sections, subsections, units, and components have different names in the **Course Outline** view and in the list of files that you'll see after you export your course and open the .xml files for editing. The following table lists the names of these elements in the **Course Outline** view and in a list of files.
+
+.. list-table::
+   :widths: 15 15
+   :header-rows: 0

-In the **Course Outline** view, your content is arranged in sections, subsections, units, and components. When you edit your course in a text editor, sections are **chapters**, subsections are **sequentials**, units are **verticals**, and components are **videos**, **HTMLs**, **problems**, or **discussions**.
+   * - Course Outline View
+     - File List
+   * - Section
+     - Chapter
+   * - Subsection
+     - Sequential
+   * - Unit
+     - Vertical
+   * - Component
+     - Discussion, HTML, problem, or video
+
+For example, when you want to find a specific section in your course, you'll look in the **Chapter** folder when you open the list of files that your course contains. To find a unit, you'll look in the **Vertical** folder.

 .. _Create a Poll:

-==========================
+=============
 Create a Poll
-==========================
+=============

 #. In the unit where you want to create the poll, create components that contain all the content that you want *except* for the poll. Make a note of the 32-digit unit ID that appears in the **Unit Identifier** field under **Unit Location**.

@@ -469,7 +486,7 @@ Create a Poll

   * For information about how to do this on a Windows computer, see `How to Make a .tar.gz on Windows <http://stackoverflow.com/questions/12774707/how-to-make-a-tar-gz-on-windows>`_.

-#. In Studio, re-import your course.
+#. In Studio, re-import your course. You can now review the poll question and answers that you added in Studio.

 .. note::


--- a/docs/en_us/course_authors/source/create_problem_component.rst
+++ b/docs/en_us/course_authors/source/create_problem_component.rst
@@ -426,13 +426,34 @@ You may want to present different students with different problems, or different

 Note that *problem randomization* is different from the **Randomization** setting in Studio. The **Randomization** setting randomizes variables within a single problem. Problem randomization offers different problems or problem versions to different students.

-.. note:: Implementing the randomization setting requires you to export your course, edit it in a text editor, and then re-import your course. We recommend that you create a backup copy of your course before you do this. We also do not recommend that you try to edit other areas of your course while you're working in the text editor unless you have the necessary background and training. 
+.. note:: Creating problems with versions that can be randomized requires you to export your course, edit some of your course's XML files in a text editor, and then re-import your course. We recommend that you create a backup copy of your course before you do this. We also recommend that you only edit the files that will contain polls in the text editor if you're very familiar with editing XML.

 ==========================
 Terminology
 ==========================

-In the **Course Outline** view, your content is arranged in sections, subsections, units, and components. When you edit your course in a text editor, sections are **chapters**, subsections are **sequentials**, units are **verticals**, and components are **videos**, **HTMLs**, **problems**, or **discussions**.
+===========
+Terminology
+===========
+
+Sections, subsections, units, and components have different names in the **Course Outline** view and in the list of files that you'll see after you export your course and open the .xml files for editing. The following table lists the names of these elements in the **Course Outline** view and in a list of files.
+
+.. list-table::
+   :widths: 15 15
+   :header-rows: 0
+
+   * - Course Outline View
+     - File List
+   * - Section
+     - Chapter
+   * - Subsection
+     - Sequential
+   * - Unit
+     - Vertical
+   * - Component
+     - Discussion, HTML, problem, or video
+
+For example, when you want to find a specific section in your course, you'll look in the **Chapter** folder when you open the list of files that your course contains. To find a unit, you'll look in the **Vertical** folder.

 .. _Create Randomized Problems: