Merge pull request #2445 from edx/sylvia/documentation/STUD-1145

Add documentation for "multiple choice and numerical input" problems

docs/en_us/course_authors/source/additional_tools.rst

+.. _Additional Tools:
+
+
+#############################
+Additional Tools
+#############################
+
+*************************
+Additional Tools Overview
+*************************
+
+Individual course teams frequently create tools and problem types that don't have templates in Studio. We want to make these tools available to all our course teams. We provide you with all the files and code that you need to create these problems in Studio.
+
+Below, you'll find the information you need to create the following tools.
+
+* :ref:`Multiple Choice and Numerical Input`
+
+.. _Multiple Choice and Numerical Input:
+
+*******************************************
+Multiple Choice and Numerical Input Problem
+*******************************************
+
+A multiple choice and numerical input problem combines a multiple choice problem with a numerical input problem. Students not only select a response from options that you provide, but also provide more specific information, if necessary.
+
+.. image:: /Images/MultipleChoice_NumericalInput.gif
+  :alt: Image of a multiple choice and numerical input problem
+
+.. note:: Currently, students can only enter numerals in the text field. Students cannot enter words or mathematical expressions.
+
+.. _Create an MCNA Problem:
+
+====================================================
+Create a Multiple Choice and Numerical Input Problem
+====================================================
+
+To create a multiple choice and numerical input problem:
+
+#. In the unit where you want to create the problem, click **Problem** under **Add New Component**, and then click the **Advanced** tab.
+#. Click **Blank Advanced Problem**.
+#. In the component that appears, click **Edit**.
+#. In the component editor, paste the code from below.
+#. Replace the example problem and response options with your own text.
+#. Click **Save**.
+
+.. _MCNA Problem Code:
+
+===================================================
+Multiple Choice and Numerical Input Problem Code
+===================================================
+
+::
+
+  <problem>
+  The numerical value of pi, rounded to two decimal points, is 3.24.
+  <choicetextresponse>
+  <radiotextgroup>
+  <choice correct="false">True.</choice>
+  <choice correct="true">False. The correct value is <numtolerance_input answer="3.14"/>.</choice>
+  </radiotextgroup>
+  </choicetextresponse>
+  </problem>
+

docs/en_us/course_authors/source/index.rst

@@ -28,6 +28,7 @@ Contents
    open_response_assessment
    google_hangouts
    tools
+   additional_tools
    set_content_releasedates
    view_course_content
    export_import_course

docs/en_us/course_authors/source/tools_unpublished.rst

-#############################
-Working with Tools
-#############################
-
-***************************
-Overview of Tools in Studio
-***************************
-
-**Intro to Tools text** - you can use various tools in Studio, etc. (Sometimes
-called blades, though that's not intuitive for very many people.)
-
-- Interactive periodic table (if we document this)
-- :ref:`Qualtrics Survey`
-- :ref:`Word Cloud`
-- :ref:`Zooming image`
-
-
-.. _Qualtrics Survey:
-
-****************
-Qualtrics Survey
-****************
-
-**description of Qualtrics survey and explanation of why course teams would want to
-use it**
-
-**image of Qualtrics survey**
-
-Create a Qualtrics Survey
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To create a Qualtrics survey, you'll use the Anonymous User ID template. This
-template contains HTML with instructions.
-
-#. Under **Add New Component**, click **html**, and then click **Anonymous User ID**.
-
-#. In the empty component that appears, click **Edit**.
-
-#. When the component editor opens, replace the example content with your own content.
-
-   - **flesh these instructions out more**
-
-   - To use your survey, you must edit the link in the template to include your university and survey ID.
-
-   - You can also embed the survey in an iframe in the HTML component.
-
-   - For more details, read the instructions in the HTML view of the component.
-
-#. Click **Save** to save the HTML component.