.. _Specialized Problems: Specialized Problems ==================== Specialized problems are advanced problems such as annotations, open response assessments, and word clouds. These problems are available through the Advanced component in Studio. To add the Advanced component to your course, you'll modify your course's advanced settings. The Advanced component then appears under **Add New Component** in each unit. - :ref:`Annotation` Annotation problems ask students to respond to questions about a specific block of text. The question appears above the text when the student hovers the mouse over the highlighted text so that students can think about the question as they read. - :ref:`Open Response Assessment` Open response assessment problems allow students to enter short answer or essay responses that students or a computer algorithm can then grade. .. _ Add Advanced Component: **Add the Advanced Component to Your Course** By default, when you create a new component in Studio, you see the following options. .. image:: Images/AddNewComponent.gif :alt: Image of the Add a New Component panel To create a specialized problem, you must first add the Advanced component to your course. To do this, follow these steps. #. On the **Settings** menu, click **Advanced Settings**. #. On the **Advanced Settings** page, locate the **Manual Policy Definition** section, and then locate the **advanced_modules** policy key (this key is at the top of the list). .. image:: Images/AdvancedModulesEmpty.gif :alt: Image of the Manual Policy Definition section of the Advanced Settings page #. Under **Policy Value**, place your cursor between the brackets, and then enter the value for the type of problem that you want to create. Make sure to include the quotation marks, but not the period. - For annotations, enter **"annotatable"**. - For open response assessments, enter **"combinedopenended","peergrading"**. (Include the comma but no spaces between the words.) - For word clouds, enter **"word_cloud"**. You can enter more than one problem type at a time. When you do, make sure to surround each problem type with quotation marks and separate each problem type with a comma, but do not include any spaces. For example, if you wanted to add annotations, open response assessments, and word cloud problems in your course, you would enter the following between the brackets. :: "annotatable","combinedopenended","peergrading","word_cloud" .. image:: Images/AdvSettings_Before.gif :alt: Image of the Manual Policy Definition section of the Advanced Settings page, with specialized problems added #. At the bottom of the page, click **Save Changes**. The page refreshes automatically. At the top of the page, you see a notification that your changes have been saved. The text in the **Policy Value** field now appears as follows. .. image:: Images/AdvSettings_After.gif :alt: Image of the Manual Policy Definition section of the Advanced Settings page, with specialized problems added after saving #. Return to the unit where you want to add the specialized problem. The list of possible components now contains an Advanced component. .. image:: Images/AdvancedComponent.gif :alt: Image of the Add a New Component panel with the Advanced component option When you click the Advanced component, you see the following list. .. image:: Images/SpecProbs_List.gif :alt: Image of the Advanced component list You can now create annotations, open response assessments, and word clouds in your course. More information about how to create each problem is provided in the page for that problem type. .. _Annotation: Annotation ---------- In an annotation problem, the instructor highlights specific text inside a larger text block and then asks questions about that text. The questions appear when students hover the mouse over the highlighted text. The questions also appear in a section below the text block, along with space for students' responses. .. image:: Images/AnnotationExample.gif :alt: Image of an annotation problem Create an Annotation Problem ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To create an annotation problem: Add the Annotation advanced component. To do this, add the "annotatable" key value to the **Advanced Settings** page. (For more information, see the instructions in :ref:`Specialized Problems`.) Add the **Instructions** and **Guided Discussion** segments of the problem. #. In the unit where you want to create the problem, click **Advanced** under **Add New Component**. #. In the list of problem types, click **Annotation**. #. In the component that appears, click **Edit**. #. In the component editor, replace the example code with your own code. #. Click **Save**. Add the **Annotation problem** segment of the problem. #. Under the Annotation component, create a new blank Advanced Problem component. #. Paste the following code in the Advanced Problem component, replacing placeholders with your own information. :: PLACEHOLDER: Text of annotation PLACEHOLDER: Text of question PLACEHOLDER: Type your response below: PLACEHOLDER: In your response to this question, which tag below do you choose?

PLACEHOLDER: Detailed explanation of solution

 #. Click **Save**. .. _Open Response Assessment: Open Response Assessment ------------------------ In open response assessments, tens of thousands of students can receive feedback on written responses of varying lengths as well as files, such as computer code or images, that the students upload. Because open response assessments are more complex than most other problem types, they have a separate section. For more information about these problems, see :ref:`Open Response Assessment Problems`.