assembleAssignment.ptx

<?xml version="1.0"?>
<section xml:id="instructor-interface_create-an-assignment">
  <title>Create an Assignment</title>
  <subsection xml:id="create_assignment_intro">
    <title>Introduction</title>

     <video xml:id="assignment-builder-video" youtube="_1C6pKu4Hxk" width="auto"/>

    <!-- old video <video xml:id="h45c7_wIgGA" youtube="h45c7_wIgGA" width="auto" /> -->
    <p>
    
      <ol marker="1">
        <li>
          <p>To create an assignment, go to Instructor Dashboard and click on the new <em>Assignment Builder</em> button under Assignments &amp; Grading
          </p>
          <figure align="center" xml:id="new_assign_fig">
            <caption>Instructor Dashboard Assignment Builder</caption>
            <image source="Figures/assignmentBuilder.png" width="100%"
              alt="assignment builder" />
          </figure>
        </li>
        <li><p>This will take you to a list of assignments that you have created or copied. 
        Click on <em>+ Create New Assignment</em> button on the top right corner of the page.</p>
        <figure align="center" xml:id="create_assign_fig">
            <caption>Create New Assignment Button</caption>
            <image source="Figures/assignmentList.png" width="100%"
              alt="Assignment List and Create New Assignment Button" />
          </figure>
        </li>
        <li><p>Fill in the basic information for the new assignment such as a name, description, 
        and due date. Then, click on the Next button. 
        The builder will give an error message if the name of the assignment is not unique among your assignments.</p>
          <figure align="center" xml:id="unique_assign_fig">
            <caption>Enter a unique name for the assignment</caption>
            <image source="Figures/assignmentBasicInfo.png" width="100%"
              alt="Assignment Basic Info" />
          </figure>
        </li>
        <li>
          <p>There are 3 types of assignments that you can create: Regular, Quiz/Exam, or Peer Instruction. 
          Choose Regular for an ordinary assignment and then click on the Create button. 
          See the next chapters for information on quizzes and peer instruction.</p>
          <figure align="center" xml:id="assign_type_fig">
            <caption>Select Assignment Type</caption>
            <image source="Figures/assignmentType.png" width="100%"
              alt="Assignment Type Selection" />
              </figure>

        </li>
        <li><p>You will be put into the assignment page with three tabs on the left: Basic Info, Readings, and Exercises.  
       Readings allow you to select whole chapters or parts of chapters for
      your students to read. You can assign points to the readings by tracking the number
      of activities they attempt in each subchapter. In readings, these are only graded for interaction, not correctness. 
      Exercises are individual problems for students to solve that can be graded for correctness, including active code, 
      short answer, multiple choice, parsons problems, etc. These can be from the ebook that you are using or even problems that you write yourself.
      An assignment can have just readings, just exercises, or both. See the subsections below for setting up Readings and Exercises.</p> 
      
      </li>
      </ol>
    </p> 

    <p>
    This <url href="https://drive.google.com/file/d/1f4xvZJyKOh4IE7O6iWbC4M-fg3V1zmZN/view?usp=sharing">Scribe document</url> illustrates how to create, edit and grade assignments in Runestone step by step with screenshots.
    </p>
  </subsection>

  <subsection xml:id="instructor-interface_creating-a-reading-assignment">
    <title>Adding Readings</title>
    <p>Click on the Readings tab and then the <em>Choose Readings</em> button. 
    Choose subchapters or pages that you want your students to read. 
    Click on a white space below the pop up menu to close it when you are done selecting readings.
    </p>
    <figure align="center" xml:id="choose_readings_fig">
      <caption>Choose Readings Button</caption>
      <image source="Figures/assignmentReadings.png" width="100%"
        alt="Choose Readings" />
    </figure>
    
    
    <p>There are 2 things you can change for each reading:</p>
    <p>
      <ul>
        <li>
          <p># required: How many of the activities on the page do you students need to do in order
            to get the points for this section. These are only graded for interaction or attempts, not correctness. They will get 1 activity for visiting the page. By default, this is set to 75% of the number 
            of activities on the page. Please remember that the number required for the points is all or nothing, so if they miss one they will not get the points.
            This is why it may be better to leave it at 75% or a little below the number of activities in case they miss one.  </p>
        </li>
        <li>
          <p>Points: How many points for completing this section. You can click on the pencil button at the top if you want to change the number of points for all the readings at once. </p>
        </li>
      </ul>
    </p>
  </subsection>
  <subsection xml:id="instructor-interface_creating-a-problem-assignment">
    <title>Adding Exercises</title>
    <p>Click on the Exercises tab on the left to add individual exercises for students to do that can be graded for correctness. 
    Then, click on the <em>+ Add Exercises</em> button on the right. 
    You will see 3 choices: Browse Chapter Exercises, Search Exercise, and Create New Exercise. 
    Click on <em>Browse Chapter Exercises</em> to choose exercises.  </p>
    <figure align="center" xml:id="choose_exercises_fig">
      <caption>Choose Exercises Button</caption>
      <image source="Figures/assignmentExercises.png" width="100%"
        alt="Choose Exercises" />
    </figure>

   <p>Scroll to the chapter and subchapters that you want and click on the triangles next to them to expand them. 
   When you see the exercises, you can click to choose them or click the eye to preview them before choosing. 
   Exercises can be from the ebook that you are using, written by its author, or contributed by the community. 
   If the exercise has a name that starts with the ebook's name like "csawesome2__" and has a book icon under the source column, then it is 
   from the ebook, shown in the red box below. If it has a percon icon under Source, it is contributed by another teacher in the community, shown in the purple box below.
   There are also controls in the green box below that can be used to filter by problem type or to just show the problems from the book.   
   After selecting problems, click on the orange Choose exercises button to add them to the assignment. 
   </p>
   <figure align="center" xml:id="browse_exercises_fig">
      <caption>Browse Exercises</caption>
      <image source="Figures/assignmentExerciseSelect.png" width="100%"
        alt="Browse Exercises" />
        </figure>

    <p>After adding the exercisee to the assignment, you will see the list of exercises you have chosen. You can drag to reorder them. 
    And there are 3 things you can change for each exercise:</p>
    <figure align="center" xml:id="exercise_list_fig">
      <caption>Exercise List</caption>
      <image source="Figures/assignmentExercisesList.png" width="100%"
        alt="Exercise List" />
        </figure>
    <p>
      <ul>
      <li>
          <p>Autograde: options here are % correct, All or nothing, Interaction, or manual. If the exercise has unit test autograding code,
          it will be set to "% correct". If it does not have autograding, it will be set to manual, where you will need to grade it.</p>
        </li>
        <li>
          <p>Which to Grade: Best Answer, first answer or last answer</p>
        </li>
              <li>
          <p>Points: how many points for this question. The pencil button at the top of each column can be used to change the
           number of points for all the exercises at once.</p>
        </li>
      </ul>
    </p>
   

 <p>Some books have large quizbanks of community contributed questions. However, some of these community contributed exercises might have errors. If you are previewing a question and it
      is obviously bad, or incorrect, or just someone experimenting, use the <term>Flag Question</term>
      button to let us know. We have volunteer editors that help us clear out or correct these bad
      questions. </p>

<p>You can also Search Exercises by name or keyword or author if you are looking for something specific. Click on <em>Add Exercises</em> button and then select <em>Search Exercises</em> instead of Browse Chapter Exercises. Type in a search word and enter in the search box. You can filter by type. The default is to search for exercises associated with the ebook that you are in, but you can toggle "Book Exercises" to "All Exercises" to search for exercises in other books. You can then click to select or preview exercises from the results and then click on the orange Choose Exercises button to add them to the assignment. You can also Copy Exercises to change them.</p>
<figure align="center" xml:id="search_exercises_fig">
      <caption>Search Exercises</caption>   
      <image source="Figures/AssignmentExercisesSearch.png" width="100%"
        alt="Search Exercises" />
        </figure>

<p>When you are done adding exercises, click on the back arrow by the assignment name or on the Assignment Builder button at the top to return to the main assignment list page. By default, the new assignment will not be visible to students. </p>
       <warning>
            <title>Make it Visible</title>
            <p>Please make sure that you slide the visibility toggle of an assignment in the assignments list to visible when you want your students to see it. If you forget to toggle this to visible, then the assignment will not show up in the list that your students can see on the assignment page.</p>
          </warning>
  </subsection>

  <subsection xml:id="subsec-accommodations">
    <title>Accommodations</title>
    <introduction>
    <p>Runestone allows you to create accommodations for students who need them. You can create an
      accommodation for a student in the Instructor Dashboard by clicking on <em>Manage Accommodations</em> under the <em>Student Management</em> menu or use the link from the course home page. There are three kinds of accommodations
      that you can create: <ul>
        <li>Extra Time on Timed Assessments</li>
        <li>Extended Due Date</li>
        <li>Allow student to see/access assignments not visible to others</li>
      </ul>
    </p>
    <figure
      xml:id="accommodations-builder">
      <caption>Creating Accommodations</caption>
      <image source="Figures/accommodations.png" width="75%" />
    </figure>
    </introduction>
    <subsubsection
      xml:id="subsubsec-ExamTime">
      <title>Extra Exam Time</title>
      <p>When you create an accommodation for extra time on timed assessments, you can specify a
        multiplier for the extra time that the student will receive. Normally this is something like
        1.5 or 2.0 for the student. This extra time will be
        added to the time limit for any timed assessments that the student takes. The student will
        see the extra time on the exam page.</p>
      <p>You can set this accommodation for a specific student or for a group of students. If you
        set it for a group of students, then all students in that group will receive the extra
        time. If you set it for a specific student, then only that student will receive the extra
        time. You can set it once by just selecting one or more students and setting the multiplier
        value. This will then apply to ALL assignments. It can be ovverridden for a specific
        assignment at any time, as a specific assignment will take priority over the general
        accommodation.
      </p>
    </subsubsection>
    <subsubsection
      xml:id="subsubsec-extended-due-date">
      <title>Extended Due Date</title>
      <p>When you create an accommodation for an extended due date, you specify the number of
        extra days that the student will have to complete the assignment. This can be set for a
        specific student or for a group of students. If you set it for a group of students, then all
        students in that group will receive the extra time. If you set it for a specific student,
        then
        only that student will receive the extra time. You can set it once by just selecting one or
        more students and setting the number of extra days. This will then apply to ALL assignments.
        It can be ovverridden for a specific assignment at any time, as a specific assignment will
        take priority over the general accommodation.
      </p>
      <p>If you need to grant a further extension, you can do so by creating a new accommodation
        with more days. If you gave them 3 days at first, but that wasn't enough, you can enter 5
        days
        to give them an additional 2 days.
      </p>
    </subsubsection>
    <subsubsection
      xml:id="subsubsec-visibility">
      <title>Visibility</title>
      <p>This is for situations where the assignment is not visible to the students, but you would
        like to mail the student a link to an exam, maybe a makeup exam. Or an extra assignment, or
        whatever. This accommodation requires both a student and an assignment. When the
        accommodation
        is saved, then the assignment will show up for the student in their assignment list, or you
        can email the student a link to the assignment and they will have access.</p>
    </subsubsection>
  </subsection>
</section>