From 22aadbfe2352e8cd28b9ba364f691897b39fcede Mon Sep 17 00:00:00 2001 From: Sylvia Pearce Date: Tue, 25 Feb 2014 16:29:26 -0500 Subject: [PATCH 1/4] Add info for polls --- .../source/Images/PollExample.png | Bin 0 -> 23753 bytes .../source/additional_tools.rst | 45 ++++++++++++++++++ 2 files changed, 45 insertions(+) create mode 100644 docs/en_us/course_authors/source/Images/PollExample.png diff --git a/docs/en_us/course_authors/source/Images/PollExample.png b/docs/en_us/course_authors/source/Images/PollExample.png new file mode 100644 index 0000000000000000000000000000000000000000..e21602952fe036d81c9cb2c866d40f68f51e1b20 GIT binary patch literal 23753 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 JmPtdu{ueV<$J+n^ literal 0 HcmV?d00001 diff --git a/docs/en_us/course_authors/source/additional_tools.rst b/docs/en_us/course_authors/source/additional_tools.rst index c49ab82a4c..925607276c 100644 --- a/docs/en_us/course_authors/source/additional_tools.rst +++ b/docs/en_us/course_authors/source/additional_tools.rst @@ -18,6 +18,7 @@ Below, we provide you with all the files and code that you need to create the fo * :ref:`Interactive Periodic Table` * :ref:`Molecule Editor` * :ref:`Multiple Choice and Numerical Input` +* :ref:`Polls` * :ref:`Protein Builder` .. _Gene Explorer: @@ -387,6 +388,50 @@ Multiple Choice and Numerical Input Problem Code +.. _Polls: + +****** +Polls +****** + +You can run polls in your course to gauge students' responses to different questions. + +.. image:: /Images/PollExample.png + +Create a Unit all the Components you want other than the polls (see "Regular Section" for an example of a pre-poll section). +Export the tarball of your course ("Tools") +Find the problem you wish to edit in the "verticals" folder. Open it with a text editor (an editor such as Sublime 2 is geared towards programming). +Add poll questions in between the and tags. A template is below. + +.. code-block:: xml + +

This is where you put the prompt

+ Yes + No + + +As a result, your code should look something like the below: + +.. code-block:: xml + + + +

This is where you put the prompt

+ Yes + No + + + + +Re-tarball your course (how to do this in Terminal here) +Import the tarball +Notes + +Although the polls will render correctly in Studio, you will not be able to edit them in Studio. You will need to follow the export/import process outlined above to make any edits to your polls. +You will be editing the raw XML code of your course to add this feature. We do not recommend attempting to edit other areas of your course in this method unless you have the necessary background and training. +A CSV for student responses to the problem is not currently available for polls, though the aggregate data is easily obtained directly in the problem. + + .. _Protein Builder: ************************ From 556f6bb0a463de483be79114cf39f0f583635816 Mon Sep 17 00:00:00 2001 From: Sylvia Pearce Date: Thu, 27 Feb 2014 17:07:33 -0500 Subject: [PATCH 2/4] Further updates to Polls --- .../source/additional_tools.rst | 27 ++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/docs/en_us/course_authors/source/additional_tools.rst b/docs/en_us/course_authors/source/additional_tools.rst index 925607276c..eb07777b80 100644 --- a/docs/en_us/course_authors/source/additional_tools.rst +++ b/docs/en_us/course_authors/source/additional_tools.rst @@ -394,10 +394,35 @@ Multiple Choice and Numerical Input Problem Code Polls ****** -You can run polls in your course to gauge students' responses to different questions. +You can run polls in your course so that your students can share opinions on different questions. .. image:: /Images/PollExample.png +Note that 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. + +========================== +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**. + +.. _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. + +#. Export your course. For information about how to do this, see :ref:`Exporting and Importing a Course`. Save your course in a memorable location so that you can find it easily. + +#. Locate the .tar.gz file that contains your course, and then unpack the file. + + - To do this on a Windows computer, you'll need to download a third-party program. For more information, see `How to Unpack a tar File in Windows `_, `How to Extract a Gz File `_, `The gzip Home Page `_, or the `Windows `_ section of the `How to Open .tar.gz Files` `_ page. + + - For information about how to do this on a Mac, see the `Mac OS X `_ section of the `How to Open .tar.gz Files` `_ page. + + Create a Unit all the Components you want other than the polls (see "Regular Section" for an example of a pre-poll section). Export the tarball of your course ("Tools") Find the problem you wish to edit in the "verticals" folder. Open it with a text editor (an editor such as Sublime 2 is geared towards programming). From 3bc8a41fc1524e41268668362beddd547b76db17 Mon Sep 17 00:00:00 2001 From: Sylvia Pearce Date: Fri, 28 Feb 2014 13:15:26 -0500 Subject: [PATCH 3/4] Add polls and randomization to problem information --- .../source/additional_tools.rst | 79 +++++++---- .../course_authors/source/common_problems.rst | 131 ++++++------------ .../source/create_problem_component.rst | 84 ++++++++++- 3 files changed, 172 insertions(+), 122 deletions(-) diff --git a/docs/en_us/course_authors/source/additional_tools.rst b/docs/en_us/course_authors/source/additional_tools.rst index eb07777b80..5b414749b2 100644 --- a/docs/en_us/course_authors/source/additional_tools.rst +++ b/docs/en_us/course_authors/source/additional_tools.rst @@ -398,7 +398,7 @@ You can run polls in your course so that your students can share opinions on dif .. image:: /Images/PollExample.png -Note that 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. +.. 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. ========================== Terminology @@ -412,49 +412,70 @@ In the **Course Outline** view, your content is arranged in sections, subsection 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. +#. 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**. -#. Export your course. For information about how to do this, see :ref:`Exporting and Importing a Course`. Save your course in a memorable location so that you can find it easily. +#. Export your course. For information about how to do this, see :ref:`Exporting and Importing a Course`. Save the .tar.gz file that contains your course in a memorable location so that you can find it easily. -#. Locate the .tar.gz file that contains your course, and then unpack the file. +#. Locate the .tar.gz file that contains your course, and then unpack the .tar.gz file so that you can see its contents in a list of folders and files. - - To do this on a Windows computer, you'll need to download a third-party program. For more information, see `How to Unpack a tar File in Windows `_, `How to Extract a Gz File `_, `The gzip Home Page `_, or the `Windows `_ section of the `How to Open .tar.gz Files` `_ page. + - To do this on a Windows computer, you'll need to download a third-party program. For more information, see `How to Unpack a tar File in Windows `_, `How to Extract a Gz File `_, `The gzip Home Page `_, or the `Windows `_ section of the `How to Open .tar.gz Files `_ page. - - For information about how to do this on a Mac, see the `Mac OS X `_ section of the `How to Open .tar.gz Files` `_ page. + - For information about how to do this on a Mac, see the `Mac OS X `_ section of the `How to Open .tar.gz Files `_ page. +#. In the list of folders and files, open the **Vertical** folder. -Create a Unit all the Components you want other than the polls (see "Regular Section" for an example of a pre-poll section). -Export the tarball of your course ("Tools") -Find the problem you wish to edit in the "verticals" folder. Open it with a text editor (an editor such as Sublime 2 is geared towards programming). -Add poll questions in between the and tags. A template is below. + .. note:: If your unit is not published, open the **Drafts** folder, and then open the **Vertical** folder in the **Drafts** folder. -.. code-block:: xml - -

This is where you put the prompt

- Yes - No - +#. In the **Vertical** folder, locate the .xml file that has the same name as the unit ID that you noted in step 1, and then open the file in a text editor such as Sublime 2. For example, if the unit ID is e461de7fe2b84ebeabe1a97683360d31, you'll open the e461de7fe2b84ebeabe1a97683360d31.xml file. -As a result, your code should look something like the below: + The file contains a list of all the components in the unit, together with the URL names of the components. For example, the following file contains an HTML component followed by a Discussion component. -.. code-block:: xml - - + .. code-block:: xml + + + + + + +#. Add the following poll code in the location where you want the poll. Change the text of the prompt to the text that you want. + + .. code-block:: xml + -

This is where you put the prompt

+

Text of the prompt

Yes No - - -Re-tarball your course (how to do this in Terminal here) -Import the tarball -Notes + In the example above, if you wanted your poll to appear between the HTML component and the Discussion component in the unit, your code would resemble the following. -Although the polls will render correctly in Studio, you will not be able to edit them in Studio. You will need to follow the export/import process outlined above to make any edits to your polls. -You will be editing the raw XML code of your course to add this feature. We do not recommend attempting to edit other areas of your course in this method unless you have the necessary background and training. -A CSV for student responses to the problem is not currently available for polls, though the aggregate data is easily obtained directly in the problem. + .. code-block:: xml + + + + +

Text of the prompt

+ Yes + No + + + + +#. After you add the poll code, save and close the .xml file. + +#. Re-package your course as a .tar.gz file. + + * For information about how to do this on a Mac, see `How to Create a Tar GZip File from the Command Line `_. + + * For information about how to do this on a Windows computer, see `How to Make a .tar.gz on Windows `_. + +#. In Studio, re-import your course. + +.. note:: + + * Although polls render correctly in Studio, you cannot edit them in Studio. You will need to follow the export/import process outlined above to make any edits to your polls. + + * A .csv file that contains student responses to the problem is not currently available for polls. However, you can obtain the aggregate data directly in the problem. .. _Protein Builder: diff --git a/docs/en_us/course_authors/source/common_problems.rst b/docs/en_us/course_authors/source/common_problems.rst index 1c4134cec4..c21d846eb9 100644 --- a/docs/en_us/course_authors/source/common_problems.rst +++ b/docs/en_us/course_authors/source/common_problems.rst @@ -29,59 +29,6 @@ These problems are easy to access in Studio. To create them, click Types** tab, and then click the name of the problem. (Note that **Checkbox** doesn't appear in the list of common problem types. To create a checkbox problem, you'll click **Blank Common Problem**.) - - - - - - - - - - - - - - - -To add labels to these problems, enclose the text that you want to use as a label in two sets of angle brackets (<<>>) - - - -Just in case you want to see the XML, we've provided it - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - .. _Checkbox: @@ -652,49 +599,49 @@ text that students enter. .. code-block:: xml - -

Example Problem

+ +

Example Problem

-

What base is the decimal numeral system in? - - +

What base is the decimal numeral system in? + + + +

+ +

What is the value of the standard gravity constant g, measured in m/s2? Give your answer to at least two decimal places. + + + -

+

-

What is the value of the standard gravity constant g, measured in m/s2? Give your answer to at least two decimal places. - - - - -

+ + - - - -

What is the distance in the plane between the points (pi, 0) and (0, e)? You can type math. - - - - -

- -
-

Explanation

-

The decimal numerical system is base ten.

-

The standard gravity constant is defined to be precisely 9.80665 m/s2. - This is 9.80 to two decimal places. Entering 9.8 also works.

-

By the distance formula, the distance between two points in the plane is - the square root of the sum of the squares of the differences of each coordinate. - Even though an exact numerical value is checked in this case, the - easiest way to enter this answer is to type - sqrt(pi^2+e^2) into the editor. - Other answers like sqrt((pi-0)^2+(0-e)^2) also work. -

-
- - +

What is the distance in the plane between the points (pi, 0) and (0, e)? You can type math. + + + + +

+ +
+

Explanation

+

The decimal numerical system is base ten.

+

The standard gravity constant is defined to be precisely 9.80665 m/s2. + This is 9.80 to two decimal places. Entering 9.8 also works.

+

By the distance formula, the distance between two points in the plane is + the square root of the sum of the squares of the differences of each coordinate. + Even though an exact numerical value is checked in this case, the + easiest way to enter this answer is to type + sqrt(pi^2+e^2) into the editor. + Other answers like sqrt((pi-0)^2+(0-e)^2) also work. +

+
+ + **Templates** diff --git a/docs/en_us/course_authors/source/create_problem_component.rst b/docs/en_us/course_authors/source/create_problem_component.rst index a0be560720..51c9397ce6 100644 --- a/docs/en_us/course_authors/source/create_problem_component.rst +++ b/docs/en_us/course_authors/source/create_problem_component.rst @@ -22,6 +22,7 @@ For more information, see the following topics. * :ref:`Components and the User Interface` * :ref:`Problem Settings` * :ref:`Multiple Problems in One Component` +* :ref:`Problem Randomization` * :ref:`Modifying a Released Problem` @@ -415,7 +416,88 @@ attempts to answer each problem individually. If a student clicks If a student clicks **Show Answer**, the answers for all the problems in the component appear. -.. _Modifying a Released Problem: +.. _Problem Randomization: + +********************* +Problem Randomization +********************* + +You may want to present different students with different problems, or different versions of the same problem. To do this, you'll create a Problem component for each problem or version in Studio, and then edit your course outside of Studio to randomize the problem that students see. + +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. + +========================== +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**. + +.. _Create Randomized Problems: + +========================== +Create Randomized Problems +========================== + +#. In the unit where you want to create a randomized problem, create a separate Problem component for each version or problem that you want to randomize. For example, if you want to offer four versions or problems, you'll create four separate Problem components. Make a note of the 32-digit unit ID that appears in the **Unit Identifier** field under **Unit Location**. + +#. Export your course. For information about how to do this, see :ref:`Exporting and Importing a Course`. Save the .tar.gz file that contains your course in a memorable location so that you can find it easily. + +#. Locate the .tar.gz file that contains your course, and then unpack the .tar.gz file so that you can see its contents in a list of folders and files. + + - To do this on a Windows computer, you'll need to download a third-party program. For more information, see `How to Unpack a tar File in Windows `_, `How to Extract a Gz File `_, `The gzip Home Page `_, or the `Windows `_ section of the `How to Open .tar.gz Files `_ page. + + - For information about how to do this on a Mac, see the `Mac OS X `_ section of the `How to Open .tar.gz Files `_ page. + +#. In the list of folders and files, open the **Vertical** folder. + + .. note:: If your unit is not published, open the **Drafts** folder, and then open the **Vertical** folder in the **Drafts** folder. + +#. In the **Vertical** folder, locate the .xml file that has the same name as the unit ID that you noted in step 1, and then open the file in a text editor such as Sublime 2. For example, if the unit ID is e461de7fe2b84ebeabe1a97683360d31, you'll open the e461de7fe2b84ebeabe1a97683360d31.xml file. + + The file contains a list of all the components in the unit, together with the URL names of the components. For example, the following file contains four Problem components. + + .. code-block:: xml + + + + + + + + +#. Add `` `` tags around the components for the problems that you want to randomize. + + .. code-block:: xml + + + + + + + + + + +#. After you add the `` `` tags, save and close the .xml file. + +#. Re-package your course as a .tar.gz file. + + * For information about how to do this on a Mac, see `How to Create a Tar GZip File from the Command Line `_. + + * For information about how to do this on a Windows computer, see `How to Make a .tar.gz on Windows `_. + +#. In Studio, re-import your course. + +.. note:: + + * Once you've implemented randomization, you can only see one of the versions or problems in Studio. You can edit that single problem directly in Studio, but to edit any of the other problems, you'll have to export your course, edit the problems in a text editor, and then re-import the course. This is true for instructors as well as course teams. + + * A .csv file for student responses contains the responses to each of the problems in the problem bank. + + + .. _Modifying a Released Problem: ************************************ Modifying a Released Problem From 19707d2776525291e41ed54524951e245e5a4414 Mon Sep 17 00:00:00 2001 From: Sylvia Pearce Date: Fri, 28 Feb 2014 16:18:11 -0500 Subject: [PATCH 4/4] Edits to polls and problem randomization --- .../source/additional_tools.rst | 31 ++++++++++++++----- .../source/create_problem_component.rst | 25 +++++++++++++-- 2 files changed, 47 insertions(+), 9 deletions(-) diff --git a/docs/en_us/course_authors/source/additional_tools.rst b/docs/en_us/course_authors/source/additional_tools.rst index 5b414749b2..f014ad8c1d 100644 --- 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 -========================== +=========== -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**. +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 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 `_. -#. 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:: diff --git a/docs/en_us/course_authors/source/create_problem_component.rst b/docs/en_us/course_authors/source/create_problem_component.rst index 51c9397ce6..b3f9e05e95 100644 --- 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: