diff --git a/docs/en_us/course_authors/source/change_log.rst b/docs/en_us/course_authors/source/change_log.rst index ee1e7f1cc4..79ebfb15b0 100644 --- a/docs/en_us/course_authors/source/change_log.rst +++ b/docs/en_us/course_authors/source/change_log.rst @@ -12,17 +12,17 @@ April, 2014 * - Date - Change - * - 04/24/14 + * - 04/24/14 - Expanded the :ref:`Grades` chapter to include topics on interpreting the grade reports and student progress page. * - 04/23/14 - Reorganized info about problems into :ref:`Exercises and Tools Index` section * - 04/22/14 - - Updated the :ref:`Bulk Email` section with information about the dashboard option to opt out of course email. + - Updated the :ref:`Bulk Email` section with information about the dashboard option to opt out of course email. * - - In :ref:`Discussions`, corrected the steps to "Create Discussion Categories". * - - - Updated the :ref:`Enrollment` section to reflect feature changes. + - Updated the :ref:`Enrollment` section to reflect feature changes. * - 04/16/14 - Updated "Transcripts in Additional Languages" in :ref:`Working with Video Components`. * - diff --git a/docs/en_us/course_authors/source/exercises_tools/multiple_choice.rst b/docs/en_us/course_authors/source/exercises_tools/multiple_choice.rst index 7c0d4173f9..f0d5f3b57e 100644 --- a/docs/en_us/course_authors/source/exercises_tools/multiple_choice.rst +++ b/docs/en_us/course_authors/source/exercises_tools/multiple_choice.rst @@ -9,6 +9,8 @@ In multiple choice problems, students select one option from a list of answer op .. image:: /Images/MultipleChoiceExample.png :alt: Image of a multiple choice problem +Multiple choice problems also have several advanced options, such as presenting a random set of choices to each student. For more information about these options, see :ref:`Multiple Choice Advanced Options`. + **************************************** Create a Multiple Choice Problem **************************************** @@ -100,6 +102,254 @@ To create this problem in the Advanced Editor, click the **Advanced** tab in the +.. _Multiple Choice Advanced Options: + +********************************************* +Advanced Options for Multiple Choice Problems +********************************************* + +Multiple choice problems have several advanced options. You can change the order of answers in the problem, include explanations that appear when a student selects a specific incorrect answer, or present a random set of choices to each student. For more information, see the following: + + +* :ref:`Shuffle Answers in a Multiple Choice Problem` +* :ref:`Targeted Feedback in a Multiple Choice Problem` +* :ref:`Answer Pools in a Multiple Choice Problem` + +.. _Shuffle Answers in a Multiple Choice Problem: + +============================================= +Shuffle Answers in a Multiple Choice Problem +============================================= + +Optionally, you can configure a multiple choice problem so that it shuffles the order of possible answers. + +For example, one view of the problem could be: + +.. image:: ../Images/multiple-choice-shuffle-1.png + :alt: Image of a multiple choice problem + +And another view of the same problem, for another student or for the same student of a subsequent view of the unit, could be: + +.. image:: ../Images/multiple-choice-shuffle-2.png + :alt: Image of a multiple choice problem with shuffled answers + +You can also have some answers shuffled, but not others. For example, you may want to have the answer "All of the Above" fixed at the end of the list, but shuffle other answers. + +You can configure the problem to shuffle answers through :ref:`Simple Editor` or :ref:`Advanced Editor`. + + +Use the Simple Editor to Shuffle Answers +********************************************* + +You can configure the problem to shuffle answers in :ref:`Simple Editor`. + +For example, the following text defines a multiple choice problem, before shuffling is enabled. The ``(x)`` indicates the correct answer:: + + >>What Apple device competed with the portable CD player?<< + ( ) The iPad + ( ) Napster + (x) The iPod + ( ) The vegetable peeler + +To add shuffling to this problem, add ``!`` in the parenthesis of the first answer:: + + >>What Apple device competed with the portable CD player?<< + (!) The iPad + ( ) Napster + (x) The iPod + ( ) The vegetable peeler + +To fix an answer's location in the list, add ``@`` in the parenthesis of that answer:: + + >>What Apple device competed with the portable CD player?<< + (!) The iPad + ( ) Napster + (x) The iPod + ( ) The vegetable peeler + (@) All of the above + +You can combine symbols within parenthesis as necessary. For example, to show the correct answer in a fixed location, you could use:: + + (x@) The iPod + +Use the Advanced Editor to Shuffle Answers +********************************************* + +You can configure the problem to shuffle answers through XML in :ref:`Advanced Editor`. + +For example, the following XML defines a multiple choice problem, before shuffling is enabled: + +.. code-block:: xml + +

What Apple device competed with the portable CD player?

+ + + The iPad + Napster + The iPod + The vegetable peeler + + + + +To add shuffling to this problem, add ``shuffle="true"`` to the ```` element: + +.. code-block:: xml + +

What Apple device competed with the portable CD player?

+ + + The iPad + Napster + The iPod + The vegetable peeler + + + +To fix an answer's location in the list, add ``fixed="true"`` to the ``choice`` element for the answer: + +.. code-block:: xml + +

What Apple device competed with the portable CD player?

+ + + The iPad + Napster + The iPod + The vegetable peeler + All of the above + + + + +.. _Targeted Feedback in a Multiple Choice Problem: + +=============================================== +Targeted Feedback in a Multiple Choice Problem +=============================================== + +You can configure a multiple choice problem so that explanations for incorrect answers are automatically shown to students. You can use these explanations to guide students towards the right answer. Therefore, targeted feedback is most useful for multiple choice problems for which students are allowed multiple attempts. + + +Use the Advanced Editor to Configure Targeted Feedback +******************************************************** + +You configure the problem to provide targeted feedback through XML in :ref:`Advanced Editor`. + +Follow these XML guidelines: + +* Add a ``targeted-feedback`` attribute to the ```` element, with no value: ```` +* Add a ```` element before the ```` element. +* Within ````, add one or more ```` elements. +* Within each ```` element, enter your explanation for the incorrect answer in HTML as markup described below. +* Connect the ```` element with a specific incorrect answer by using the same ``explanation-id`` attribute value for each. +* Use the ```` element for the correct answer, with the same ``explanation-id`` attribute value as the correct ```` element. + +For example, the XML for the multiple choice problem is: + +.. code-block:: xml + +

What Apple device competed with the portable CD player?

+ + + The iPad + Napster + The iPod + The vegetable peeler + + + +This is followed by XML that defines the targeted feedback: + +.. code-block:: xml + + + +
+

Targeted Feedback

+

The iPad came out later and did not directly compete with portable CD players.

+
+ + +
+

Targeted Feedback

+

Napster was not an Apple product.

+
+ + +
+

Targeted Feedback

+

Vegetable peelers don't play music.

+
+ + + + +
+

The iPod directly competed with portable CD players.

+
+ + + +.. _Answer Pools in a Multiple Choice Problem: + +============================================= +Answer Pools in a Multiple Choice Problem +============================================= + +You can configure a multiple choice problem so that a random subset of choices are shown to each student. For example, you can add 10 possible choices to the problem, and each student views a set of five choices. + +The answer pool must have at least one correct answer, and can have more than one. In each set of choices shown to a student, one correct answer is included. For example, you may configure two correct answers in the set of 10. One of the two correct answers is included in each set a student views. + +Use the Advanced Editor to Configure Answer Pools +************************************************** + +You configure the problem to provide answer pools through XML in :ref:`Advanced Editor`. + +Follow these XML guidelines: + +* In the ```` element, add the ``answer-pool`` attribute, with the numerical value indicating the number of possible answers in the set. For example, ````. + +* For each correct answer, to the ```` element, add an ``explanation-id`` attribute and value that maps to a solution. For example, ``The iPod``. + +* For each ```` element, add an ``explanation-id`` attribute and value that maps back to a correct answer. For example, ````. + +.. note:: If the choices include only one correct answer, you do not have to use the ``explanation-id`` in either the ``choice`` or ```` element. You do still use the ```` element to wrap the ```` element. + +For example, for the following multiple choice problem, a student will see four choices, and in each set one of the choices will be one of the two correct ones. The explanation shown for the correct answer is the one with the same explanation ID. + +.. code-block:: xml + + +

What Apple devices let you carry your digital music library in your pocket?

+ + + The iPad + Napster + The iPod + The vegetable peeler + The iMac + The iPhone + + + + + +
+

Explanation

+

Yes, the iPod is Apple's portable digital music player.

+
+ + +
+

Explanation

+

In addition to being a cell phone, the iPhone can store and play your digital music.

+
+ + + + + .. _Multiple Choice Problem XML: ******************************