CSC/ECE 517 Spring 2018- Project E1824: Let course staff as well as students do reviews: Difference between revisions
Jump to navigation
Jump to search
(Added details related to problem statement and proposed solutions) |
(Design document for this project) |
||
| Line 2: | Line 2: | ||
The way Expertiza is set up right now is that only peers can review your work. However, there are cases when the instructor would want to submit reviews as well. This project aims to implement this feature by allowing instructors to review the project on the same metrics as other students who review the project. | The way Expertiza is set up right now is that only peers can review your work. However, there are cases when the instructor would want to submit reviews as well. This project aims to implement this feature by allowing instructors to review the project on the same metrics as other students who review the project. | ||
== '''Problem Statement''' == | == '''Problem Statement''' == | ||
| Line 8: | Line 9: | ||
* Sometimes, the peer reviews may not be thorough and the team/person's work reviewed might not reflect the actual status of the development. | * Sometimes, the peer reviews may not be thorough and the team/person's work reviewed might not reflect the actual status of the development. | ||
* The reviewer might not know how well they are reviewing the peer's work. They might not entirely know as to what tone to use or what suggestions to put forward. | * The reviewer might not know how well they are reviewing the peer's work. They might not entirely know as to what tone to use or what suggestions to put forward. | ||
By letting course staff perform reviews as well, the reviewer and the reviewee are both benefited, which can improve the overall learning experience. | |||
=== Current scenario === | === Current scenario === | ||
This is how some of the pages we are concerned with, currently look. | |||
==== Submissions page for an assignment in Instructor View ==== | ==== Submissions page for an assignment in Instructor View ==== | ||
[[File: Submissions_instr.jpeg | center]] | [[File: Submissions_instr.jpeg | center]] | ||
| Line 18: | Line 25: | ||
==== A typical Scores table in a Student View ==== | ==== A typical Scores table in a Student View ==== | ||
[[File: Grades_view_team_current.png | center]] | [[File: Grades_view_team_current.png | center]] | ||
| Line 24: | Line 32: | ||
==== Others work reviewed in a Student View ==== | ==== Others work reviewed in a Student View ==== | ||
[[File: | [[File: Others_work_current.jpeg | center]] | ||
== '''Proposed Solutions''' == | == '''Proposed Solutions''' == | ||
| Line 33: | Line 40: | ||
We propose to perform the following changes to let staff perform reviews as well: | We propose to perform the following changes to let staff perform reviews as well: | ||
* Step 1: Add a "Perform review" link in the assignment submissions page view for the instructors. === | |||
Files to be edited: | Files to be edited: | ||
* '''View: ''' app/views/assignments/list_submissions.html.erb | * '''View: ''' ''app/views/assignments/list_submissions.html.erb'' | ||
* '''Controller: ''' app/controllers/response_controller.rb - Add authorization for instructors to perform review | * '''Controller: ''' ''app/controllers/response_controller.rb'' - Add authorization for instructors to perform review | ||
[[File: Submissions_instr_new.jpeg | center]] | [[File: Submissions_instr_new.jpeg | center]] | ||
* Step 2: Add instructor review in "Your Scores" table in case he has reviewed your work. Provide a highlight/way to make it look distinct. === | |||
Files to be edited: | Files to be edited: | ||
* '''View: ''' app/views/grades/view_team.html.erb | * '''View: ''' ''app/views/grades/view_team.html.erb'' | ||
* '''Controller: ''' app/controllers/grades_controller.rb | * '''Controller: ''' ''app/controllers/grades_controller.rb'' - Method: view_team | ||
[[File: Grades_view_team_instr.png | center]] | [[File: Grades_view_team_instr.png | center]] | ||
* Step 3: If instructor has reviewed the same work as you have reviewed, provide a way to show his review as well in "Others work" === | |||
Files to be edited: | |||
* '''View: ''' ''app/views/student_review/list.html.erb'' | |||
* '''Controller: ''' ''app/controllers/student_review_controller.rb'' - Method: view_team | |||
[[File: Others_work_proposed.jpeg | center]] | |||
Revision as of 22:24, 8 April 2018
Introduction
The way Expertiza is set up right now is that only peers can review your work. However, there are cases when the instructor would want to submit reviews as well. This project aims to implement this feature by allowing instructors to review the project on the same metrics as other students who review the project.
Problem Statement
Peer review is a great way for students to learn about how well they have developed their application. However there are some problems with this:
- Sometimes, the peer reviews may not be thorough and the team/person's work reviewed might not reflect the actual status of the development.
- The reviewer might not know how well they are reviewing the peer's work. They might not entirely know as to what tone to use or what suggestions to put forward.
By letting course staff perform reviews as well, the reviewer and the reviewee are both benefited, which can improve the overall learning experience.
Current scenario
This is how some of the pages we are concerned with, currently look.
Submissions page for an assignment in Instructor View
A typical Scores table in a Student View
Others work reviewed in a Student View
Proposed Solutions
We propose to perform the following changes to let staff perform reviews as well:
- Step 1: Add a "Perform review" link in the assignment submissions page view for the instructors. ===
Files to be edited:
- View: app/views/assignments/list_submissions.html.erb
- Controller: app/controllers/response_controller.rb - Add authorization for instructors to perform review
- Step 2: Add instructor review in "Your Scores" table in case he has reviewed your work. Provide a highlight/way to make it look distinct. ===
Files to be edited:
- View: app/views/grades/view_team.html.erb
- Controller: app/controllers/grades_controller.rb - Method: view_team
- Step 3: If instructor has reviewed the same work as you have reviewed, provide a way to show his review as well in "Others work" ===
Files to be edited:
- View: app/views/student_review/list.html.erb
- Controller: app/controllers/student_review_controller.rb - Method: view_team
Test Plan
Many of our changes would be reflected on views (user interface). Following is the list of tests that should be conducted with rspec/capybara:
- it "should see the Perform Review link (beside Assign Grade link) for each submission after a list of submissions are pulled up by an instructor if the final due date for the assignment has passed"
- it "should see the Perform Review link only for each submission after a list of submissions are pulled up by an instructor if the final due date for the assignment has not passed"
- it "should pull up a review page for the submission of the team after the Perform Review link is clicked on by an instructor"
- it "should show highlighted reviews done by instructors when a student views feedback on his/her submission"
- it "should pull up a calibration report when a student wants to see the difference between his/her reviews on other's submission and the instructor's"
Team Members
- Ashis Sahoo
- Satvik Shetty
- Xiaohui Ellis
- Kushal Nawalakha
References
Expertiza
Expertiza Github
Expertiza Documentation