Merge pull request #2099 from edx/markhoeber/documentation/fix-sylvia-615

Fixing merge for sylvia's branch bld-615

docs/course_authors/source/create_problem_component.rst

@@ -4,9 +4,9 @@
 Working with Problem Components
 ################################
 
-*********
-Overview
-*********
+******************************
+Overview of Problem Components
+******************************
 
 The problem component allows you to add interactive, automatically
 graded exercises to your course content. You can create many different
@@ -17,7 +17,7 @@ toward a student's grade. If you want the problems to count toward the
 student's grade, change the assignment type of the subsection that contains the
 problems.
 
-See the following topics:
+For more information, see the following topics.
 
 * :ref:`Components and the User Interface`
 * :ref:`Problem Settings`

docs/course_authors/source/create_lti.rst → docs/course_authors/source/tools.rst

-.. _Working with LTI Components:
+.. _Tools:
 
-Working with LTI Components
-============================
 
+#############################
+Working with Tools
+#############################
 
-Introduction to LTI Components
-------------------------------
+***************************
+Overview of Tools in Studio
+***************************
+
+In addition to text, images, and different types of problems, Studio allows you
+to add customized learning tools such as word clouds to your course.
+
+- :ref:`LTI Component`: LTI components allow you to add an external learning application
+  or textbook to Studio.
+- :ref:`Word Cloud`: Word clouds arrange text that students enter - for example, in
+  response to a question - into a colorful graphic that students can see.
+- :ref:`Zooming image`: Zooming images allow you to enlarge sections of an image so
+  that students can see the section in detail.
+
+
+.. _LTI Component:
+
+**************
+LTI Components
+**************
 
 You may have discovered or developed an external learning application
 that you want to add to your online course. Or, you may have a digital
@@ -73,7 +92,7 @@ Step 1. Add LTI to the Advanced Modules Policy Key
    then enter **“lti”**. Make sure to include the quotation marks, but
    not the period.
 
-   .. image:: Images/LTI_policy_key.gif
+   .. image:: Images/LTI_Policy_Key.gif
 
    **Note** If the **Policy Value** field already contains text, place your
    cursor directly after the closing quotation mark for the final item, and
@@ -186,3 +205,85 @@ Step 3. Add the LTI Component to a Unit
          a student’s score can be any value between 0 and 1.
 
          For more information about problem weights and computing point scores, see :ref:`Problem Weight`.
+
+.. _Word Cloud:
+
+**********
+Word Cloud
+**********
+
+
+In a word cloud exercise, students enter words into a field in response
+to a question or prompt. The words all the students have entered then
+appear instantly as a colorful graphic, with the most popular responses
+appearing largest. The graphic becomes larger as more students answer.
+Students can both see the way their peers have answered and contribute
+their thoughts to the group.
+
+
+For example, the following word cloud was created from students'
+responses to a question in a HarvardX course.
+
+.. image:: Images/WordCloudExample.gif
+
+Create a Word Cloud Exercise
+----------------------------
+
+To create a word cloud exercise:
+
+
+#. Add the Word Cloud advanced component. To do this, add the
+   "word_cloud" key value to the **Advanced Settings** page. (For more
+   information, see the instructions in :ref:`Specialized Problems`.)
+#. In the unit where you want to create the problem, click **Advanced**
+   under **Add New Component**.
+#. In the list of problem types, click **Word Cloud**.
+#. In the component that appears, click **Edit**.
+#. In the component editor, specify the settings that you want. You can
+   leave the default value for everything except **Display Name**.
+
+
+   -  **Display Name**: The name that appears in the course ribbon and
+      as a heading above the problem.
+   -  **Inputs**: The number of text boxes into which students can enter
+      words, phrases, or sentences.
+   -  **Maximum Words**: The maximum number of words that the word cloud
+      displays. If students enter 300 different words but the maximum is
+      set to 250, only the 250 most commonly entered words appear in the
+      word cloud.
+   -  **Show Percents**: The number of times that students have entered
+      a given word as a percentage of all words entered appears near
+      that word.
+
+
+#. Click **Save**.
+
+
+For more information, see `Xml Format of "Word Cloud" Module
+<https://edx.readthedocs.org/en/latest/course_data_formats/word_cloud/word_cloud.html#>`_.
+
+.. _Zooming Image:
+
+******************
+Zooming Image Tool
+******************
+
+Some edX courses use extremely large, extremely detailed graphics. To make it
+easier to understand we can offer two versions of those graphics, with the zoomed
+section showing when you click on the main view.
+
+The example below is from 7.00x: Introduction to Biology and shows a subset of the
+biochemical reactions that cells carry out.
+
+.. image:: Images/Zooming_Image.gif
+
+Create a Zooming Image Tool
+---------------------------
+
+#. Under **Add New Component**, click **html**, and then click **Zooming Image**.
+
+#. In the empty component that appears, click **Edit**.
+
+#. When the component editor opens, replace the example content with your own content.
+
+#. Click **Save** to save the HTML component.

docs/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.