7.2. Annotation Problem

In an annotation problem, you highlight specific text inside a larger text block and then ask questions about that text. The questions appear when students move their cursors over the highlighted text. The questions also appear in a section below the text block, along with space for students’ responses.

An example annotation problem.

7.2.1. Create an Annotation Problem

To create an annotation problem, you add the Annotation advanced component to your course, add the Instructions and Guided Discussion segments of the problem, and then the Annotation problem segment of the problem.

7.2.1.1. Add the Annotation Component

To add the Annotation advanced component, follow these steps.

  1. From the Settings menu select Advanced Settings.

  2. In the field for the Advanced Module List policy key, place your cursor between the brackets.

  3. Enter the following value. Make sure to include the quotation marks.

    "annotatable"

  1. At the bottom of the page, select Save Changes.

    The page refreshes automatically. At the top of the page, you see a notification that your changes have been saved.

  2. Return to the unit where you want to add the specialized problem. The list of possible components now contains an Advanced component.

    The Add a New Component panel with the Advanced component option.

7.2.1.2. Add Instructions and Guided Discussion

To add the Instructions and Guided Discussion segments of the problem, follow these steps.

  1. In the unit where you want to create the problem, under Add New Component select Advanced.
  2. In the list of problem types, select Annotation.
  3. In the component that appears, select Edit.
  4. In the component editor, replace the example code with your own code.
  5. Select Save.

7.2.1.3. Add Annotation Problem

To add the Annotation problem segment of the problem, follow these steps.

  1. Under the Annotation component, create a new blank Advanced Problem component.

  2. Paste the following code in the Advanced Problem component, replacing placeholders with your own information.

    <problem>
    <annotationresponse>
        <annotationinput>
          <text>PLACEHOLDER: Text of annotation</text>
            <comment>PLACEHOLDER: Text of question</comment>
            <comment_prompt>PLACEHOLDER: Type your response below:</comment_prompt>
            <tag_prompt>PLACEHOLDER: In your response to this question, which tag below do you choose?</tag_prompt>
          <options>
            <option choice="incorrect">PLACEHOLDER: Incorrect answer (to make this option a correct or partially correct answer, change choice="incorrect" to choice="correct" or choice="partially-correct")</option>
            <option choice="correct">PLACEHOLDER: Correct answer (to make this option an incorrect or partially correct answer, change choice="correct" to choice="incorrect" or choice="partially-correct")</option>
            <option choice="partially-correct">PLACEHOLDER: Partially correct answer (to make this option a correct or partially correct answer, change choice="partially-correct" to choice="correct" or choice="incorrect")
            </option>
          </options>
        </annotationinput>
    </annotationresponse>
    <solution>
      <p>PLACEHOLDER: Detailed explanation of solution</p>
    </solution>
  </problem>
  1. Select Save.