Peer review

Milestone 4

Project

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 teams’ projects. 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, if any. If the proposal does not include the use of a specific dataset, comment on whether the project would be strengthened by the inclusion of a dataset.

    • Describe the approaches, tools, and methods that will be used.

    • Provide constructive feedback on how the team might be able to improve their project. Make sure your feedback includes at least one comment on the statistical reasoning aspect of the project, but do feel free to comment on aspects beyond the reasoning as well.

    • What aspect of this project are you most interested in and would like to see highlighted in the presentation?

    • Were you able to reproduce the project by clicking on Render Website once you cloned it? Were there any issues with reproducibility?

    • Provide constructive feedback on any issues with file and/or code organization.

    • What have you learned from this team’s project that you are considering implementing in your own project?

    • (Optional) Any further comments or feedback?

Review pairings

Your team name Team to review 1 Team to review 2
the-outliers clav team-d
clav team-d jams
team-d jams elephants
jams elephants standard-deviants
elephants standard-deviants mutate
standard-deviants mutate the-outliers
mutate the-outliers clav
Your team name Team to review 1 Team to review 2
r-tists data-divas histogram-hotties
data-divas histogram-hotties boxplot-baddies
histogram-hotties boxplot-baddies plot-twisters
boxplot-baddies plot-twisters mean-girls
plot-twisters mean-girls sigma-squad
mean-girls sigma-squad r-tists
sigma-squad r-tists data-divas
Your team name Team to review 1 Team to review 2
SFW theoutliers ggplots
theoutliers ggplots DEBS
ggplots DEBS WABB
DEBS WABB tibble-tribe
WABB tibble-tribe histogram-hustlers
tibble-tribe histogram-hustlers commit-render-and-push
histogram-hustlers commit-render-and-push tea
commit-render-and-push tea SFW
tea SFW theoutliers
Your team name Team to review 1 Team to review 2
the-stat-attack zito-fan-club rack
zito-fan-club rack data-dynamo
rack data-dynamo standard_deviants
data-dynamo standard_deviants pretty-girls
standard_deviants pretty-girls the-outliers-2
pretty-girls the-outliers-2 the-stat-attack
the-outliers-2 the-stat-attack zito-fan-club
Your team name Team to review 1 Team to review 2
SALE CARS Hats
CARS Hats R-chitects
Hats R-chitects Above-Average
R-chitects Above-Average ATJOB
Above-Average ATJOB Chi-Squad
ATJOB Chi-Squad Best-Team
Chi-Squad Best-Team STA1NANA
Best-Team STA1NANA SALE
STA1NANA SALE CARS
Your team name Team to review 1 Team to review 2
Yin-Yang Team-Lowkey The-Frontal-Four
Team-Lowkey The-Frontal-Four Slack
The-Frontal-Four Slack Tidyverse-Titans
Slack Tidyverse-Titans Sparkly-Unicorns
Tidyverse-Titans Sparkly-Unicorns Sloths
Sparkly-Unicorns Sloths Yin-Yang
Sloths Yin-Yang Team-Lowkey
Your team name Team to review 1 Team to review 2
statisticaly-insane clue the_outliers
clue the_outliers hershey
the_outliers hershey myrtle-beasts
hershey myrtle-beasts sour-blueberries
myrtle-beasts sour-blueberries teenage-mutate-ninja-turtles
sour-blueberries teenage-mutate-ninja-turtles zito-and-gang
teenage-mutate-ninja-turtles zito-and-gang 7seas
zito-and-gang 7seas statisticaly-insane
7seas statisticaly-insane clue
Your team name Team to review 1 Team to review 2
blue-199ers cats ggballers
cats ggballers linear-legends
ggballers linear-legends group-nana
linear-legends group-nana ggplotgang
group-nana ggplotgang avant-garde
ggplotgang avant-garde blue-199ers
avant-garde blue-199ers cats
Your team name Team to review 1 Team to review 2
StandardDeviants tibble Stats-in-style
tibble Stats-in-style blue-devils
Stats-in-style blue-devils outstanding-otters
blue-devils outstanding-otters dr-mags
outstanding-otters dr-mags ggplot-aculars
dr-mags ggplot-aculars the-wild-stats
ggplot-aculars the-wild-stats gghot2go
the-wild-stats gghot2go StandardDeviants
gghot2go StandardDeviants tibble
Your team name Team to review 1 Team to review 2
the-kool-katz gameDay ocean
gameDay ocean peony
ocean peony dog
peony dog falcons
dog falcons data-diggers
falcons data-diggers the-kool-katz
data-diggers the-kool-katz gameDay

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

Note

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.