reviewer | reviewee_1 | reviewee_2 |
---|---|---|
ChilePeppers | CodingWildcats | LeanMeanLearningMachines |
CodingWildcats | LeanMeanLearningMachines | IndecisionScientists |
LeanMeanLearningMachines | IndecisionScientists | TheOutliers |
IndecisionScientists | TheOutliers | ChilePeppers |
TheOutliers | ChilePeppers | CodingWildcats |
Peer review
Milestone 3
During the peer feedback process, you will be provided read-only access to your partner team’s GitHub repo. You will provide your feedback in the form of GitHub issues to your partner team’s GitHub repo.
Goals
The goals of this milestone are as follows:
- Review others’ project drafts as a team and provide feedback
- Post issues on GitHub using an issue template
- Learn from others’ projects and improve your own project based on their strengths and weaknesses
Instructions
Review two other team’s project. As a team you should spend ~30 minutes on each team’s project.
Find the names of the teams whose projects you’re reviewing below. You should already have access to this team’s repo.
Each team member should go to the repo of the team you’re reviewing.
Then,
1-2 team members clone the team’s project and renders it to check for reproducibility.
1-2 team members open the team’s project in their browser and starts reading through the project draft.
1 team member opens an issue on the team’s repo using the peer review template.
All team members discuss the project based on the prompts on the issue template and one team member records the feedback and submits the issue.
To open an issue in the repo you’re reviewing, click on New issue, and click on Get started for the Peer review issue. Fill out this issue, answering the following questions:
Peer review by: [NAME OF TEAM DOING THE REVIEW]
Names of team members that participated in this review: [FULL NAMES OF TEAM MEMBERS DOING THE REVIEW]
Describe the goal of the project.
Describe the data used or collected.
Describe how the research question will be answered, e.g. what approaches / methods will be used.
Is there anything that is unclear from the proposal?
Provide constructive feedback on how the team might be able to improve their project.
What aspect of this project are you most interested in and would like to see highlighted in the presentation.
Provide constructive feedback on any issues with file and/or code organization.
(Optional) Any further comments or feedback?
Review pairings
The peer review assignments for peer reviews are as follows:
Grading
Peer reviews will be graded on the extent to which it comprehensively and constructively addresses the components of the reviewee’s team’s report.
Only the team members participating in the review during the lab session are eligible for points for the peer review. If you’re unable to make it to lab in person, you should arrange to virtually connect with your team during your lab session.
0 points: No peer review
1 point: Feedback provided is not constructive or actionable
2-4 points: Feedback provided is not sufficiently thorough
5 points: Peer review is constructive, actionable, and sufficiently thorough
The feedback issue will come from one team member on GitHub since you can’t collectively edit an issue. However it must represent the opinions of the entire team. It is not a single team member’s responsibility to provide feedback, they’re just the record keeper for the team.