CSC/ECE 517 Spring 2018- Project E1817: Adding Student-generated Questions to Rubric

From Expertiza_Wiki
Jump to navigation Jump to search

Introduction

Overview of Project

Expertiza contains Peer-Review where in all students are asked to review the work done by their fellow classmates. The rubric for the same are created by instructors. These Rubrics contain questions that are related to the submitted topics. But sometimes students have questions which may or may not be related to the work other students are working on. So there is no option currently available to ask these questions to their peers. This project (E1817) aims to solve this problem by allowing students to add questions to the standard instructor generated rubric so that they can get specific feedback on from the reviewers.

Proposed Solution

In order to solve the above problem, we intend to add a Supplementary Review Questions to the existing Review Questions already added by the instructor. These “extra” questions will not be graded. However, they will increase the benefit that each person gets because they can get feedback that is specific to their project. The rest of this document describes the design and approach for project E1817.

Implementation

In Expertiza, all rubrics and surveys are subclasses of Questionnaire. A Questionnaire has “questions” that make use of checkboxes, dropdowns, text boxes, etc. We want to add a new subclass of Questionnaire called SupplementaryReviewQuestionnaire to help us implement this project.

Design Strategy

The flowchart below describes the design that we chose to implement for this project.

  • When a student wants to create/edit Supplementary Review Questionnaire
    • If the instructor has enabled a particular assignment to have supplementary review questionnaire a student when clicks on the "Your Work" tab sees a link to the add/edit Supplemntary Review Questionnaire. This link directs the student to the create review questionnaire(same as instructor).
    • When a student creates a Supplementary Review Questionnaire(SRQ), a SRQ column needs to be added to the Teams Table which will contain the questionnaire id to link the SRQ with the team that generated it. If the SRQ column of a team is empty it means no supplementary review questionnaire was created. If its not empty, it will indicate that a supplementary review questionnaire was created.


  • When Reviewer wants to access the Review Questions.
    • When a reviewer requests for a review, first the entry of the SRQ column in the Teams table is checked to see if supplementary review questionnaire was added. If the field is not empty, the supplementary review questionnaire is appended to the existing review questionnaire created by the instructor. Otherwise the reviewer only sees the default review questionnaire.

  • When scores need to be displayed
    • When the response of the reviewer is recorded, the student can view the scores for a particular assignment which contains the response of the review questions. This view should contain both the scores of default review questions as well the supplementary review questions added by the student. So if the SRQ field in the Teams table is not empty the scores of the supplementary review questions is appended to the scores of the default review questions.

Changes in the UserInterface

To be able to achieve the goal for this project, we need to implement some changes in the UI.

  • Assignment Page
    • An assignment will have a checkbox that the instructor can ‘check’ to enable a supplementary review rubric. Once ‘checked’ a button or link on the page will appear. This button will take the student to the same page that an instructor lands on when creating a new rubric, which will allow the student to create a review rubric just like an instructor does.
  • A link needs to be added to the submission of the work. So when a student clicks the link he/she can add the desired questions.
  • The page where student will be directed to when he/she clicks the Supplementary Review Questionnaire link.
  • The page which allows students to add different types of questions to the Supplementary Review Questionnaire.
  • Review Page
    • When a reviewer fills out a rubric, the ResponseController will display a set of rubrics, in order, on the same page. This set would normally consist of just a review rubric, which is a Response object. However, the set would now have a review rubric and a supplementary review rubric (two items in the set instead of one) if supplementary Review rubric has been added.
  • Review Results Page
    • The “View” function for a rubric will display answers submitted for the SupplementaryReviewQuestionnaire as well as the ReviewQuestionnaire. We will also add another column to the “View scores” page (for both instructor and students) to report the scores that the students gave on these questions. The student-generated questions will not be graded to avoid encouraging students to ask “easy” questions so that their reviewers would give them a high scores.

Test Plan

Firstly, we need to add tests for the following:

1. To check the link for "Supplementary Review Questionnaire" appears in the "Your Work" section of a student.

2. To check if the link for "Supplementary Review Questionnaire" redirects to page which allows to create questionnaire.

3. To check if after creation of the supplementary questionnaire the supplementary questionnaire column of the Teams table has correct value (i.e not NIL).

Apart from these we will need to add some tests to assignments_spec and response_controller_spec to test the addition of Supplementary Review Questionnaire.

File that will be added/modified

As of now, we have figured out that the following files need to be added/modified:

1. SupplementaryQuestionnaire.rb

We need to create a subclass "SupplementaryQuestionnaire".

2. Add_Supplementary_Questionnaire_to_Teams.rb

We need to add to create a migration which will add the Supplementary Questionnaire column to the "Teams" table.

3. routes.rb

For correct switching between the various views

4. student_review_controller.rb, review_mapping_controller.rb, response_controller.rb

Files that need modification for adding Supplementary questions to the existing rubrics.

5. assignment_spec.rb

Add additional test case to test the new functionality.

6. response_controller_spec.rb

Add additional test case to test the new functionality.

NOTE : There will be additional files that need modification and some new files may also need to be added the above given list is temporary.