E1867 allow reviewer to say review can be shown to class as an example: Difference between revisions

From Expertiza_Wiki
Jump to navigation Jump to search
Line 44: Line 44:


# Consent to make the review public - add a checkbox and an oncheck event handlers (JS) that sets a new field 'visibility' to public of Response object
# Consent to make the review public - add a checkbox and an oncheck event handlers (JS) that sets a new field 'visibility' to public of Response object
# Change the schema of Responses table (add the new column) and write db migrations.   
# Change the schema of Responses table (add the new column) and write db migrations.   
# Create new table, model, view, controller for similar_assignments and validate CRUD operations that access the table.
# Create new table, model, view, controller for similar_assignments and validate CRUD operations that access the table.
# Add HTML (checkbox) to uncheck the consent such that the reviews becomes private.  
# Add HTML (checkbox) to uncheck the consent such that the reviews becomes private.  
# On the "popup/team_users_popup" page (where instructor/TA can view all reviews), for all reviews with public visibility set, add a button to mark a review as a sample.
# On the "popup/team_users_popup" page (where instructor/TA can view all reviews), for all reviews with public visibility set, add a button to mark a review as a sample.
# Write HTML for a popup that contains a list (of assignments) with checkboxes against each, and a submit button. Add validations for non-selection.
# Write HTML for a popup that contains a list (of assignments) with checkboxes against each, and a submit button. Add validations for non-selection.
# Modify view for the instructor/TA to include this popup to make the review available as sample. On submit of popup, update the similar_assignments table.
# Modify view for the instructor/TA to include this popup to make the review available as sample. On submit of popup, update the similar_assignments table.
# At the top of student_reviews/list page, add a link to a new page.  
# At the top of student_reviews/list page, add a link to a new page.  
# Create new route, model, view, controller for this new page at 'student_reviews/samples?id=<assignment_id>'. Write HTML to display the list
# Create new route, model, view, controller for this new page at 'student_reviews/samples?id=<assignment_id>'. Write HTML to display the list
of sample reviews.
of sample reviews.

Revision as of 04:09, 14 November 2018

Introduction

Expertiza is a web based open source peer reviewing tool developed and maintained by current and past students of North Carolina State University. Peer review is a great way for a student to learn how to approach a project and get ideas for their own projects. Currently, there is no way for a student to view another student's work, unless they are reviewing the other student's work.

Problem Statement

The objective of this project is to:

  1. Add a feature for students to make their reviews 'public', that is, allow other students to view them.
  2. Add a feature for TA to select a subset of 'public' reviews, and make those reviews visible as sample reviews of the particular assignment.
  3. Add a feature for Instructor to select a subset of 'public' reviews and make those reviews visible as sample reviews of any of his/her assignments in the course.
  4. Create a view where the student can see a list of sample reviews of the assignment and have a detailed view of each.
  5. Allow the student to toggle the visibility of a review he/she has submitted.

Expected Flow

As a TA / Instructor

  1. Log in
  2. Click on Manage->Assignments
  3. Displays list of Assignments
  4. Click View Report/Review for a particular assignment.
  5. Displays a list of reviews submitted by students.
  6. Click on any review in "team reviewed" column for a particular student.
  7. Displays the summary of reviews submitted by that student.
  8. Click on "Make as sample" for the intended reviews, which opens a popup that displays a list of all assignments that are a part of the instructor's courses.
  9. From this list select all assignments for which the review has to be shown as a sample.
  10. Click on 'Submit' after selection (this closes the popup).
  11. Navigate to view reviews of that particular assignment and click on "Sample Reviews".
  12. A new page is opened that lists out all the sample reviews of the assignment.


As a Student

  1. Log in.
  2. Click on Assignments
  3. List of assignments is displayed.
  4. Click on any assignment for which the review has to be submitted.
  5. Assignment description is displayed.
  6. Click on "Other's work" to submit review for other's work.
  7. At this point student can click on "Show sample reviews" to view all sample reviews for that assignment.
  8. On clicking this, it will display all the sample reviews.
  9. Student can click on back to go back to Assignment description page.
  10. Student can chose to review any of the team's assignment that is displayed.
  11. Student selects a team for review and fills in the review.
  12. Before submitting the review, student can select the check box that says "I agree to share this review anonymously as an example to the entire class".
  13. After clicking on the submit button, the review submitted by the student has been made public.

Project Tasks

  1. Consent to make the review public - add a checkbox and an oncheck event handlers (JS) that sets a new field 'visibility' to public of Response object
  2. Change the schema of Responses table (add the new column) and write db migrations.
  3. Create new table, model, view, controller for similar_assignments and validate CRUD operations that access the table.
  4. Add HTML (checkbox) to uncheck the consent such that the reviews becomes private.
  5. On the "popup/team_users_popup" page (where instructor/TA can view all reviews), for all reviews with public visibility set, add a button to mark a review as a sample.
  6. Write HTML for a popup that contains a list (of assignments) with checkboxes against each, and a submit button. Add validations for non-selection.
  7. Modify view for the instructor/TA to include this popup to make the review available as sample. On submit of popup, update the similar_assignments table.
  8. At the top of student_reviews/list page, add a link to a new page.
  9. Create new route, model, view, controller for this new page at 'student_reviews/samples?id=<assignment_id>'. Write HTML to display the list

of sample reviews.

Implementation Details

To be updated

Test Plan

To be updated

Additional Links and References

  1. Link to the Git Pull Request
  2. Expertiza on GitHub
  3. GitHub Project Repository Fork
  4. The Live Expertiza Website

Team

Amogh Agnihotri Subbanna
Chinmai Kaidabettu Srinivas
Siddu Madhure Jayanna
Suhas Naramballi Gururaja