Skip to content

Latest commit

 

History

History
138 lines (108 loc) · 5.79 KB

peer-evaluation.md

File metadata and controls

138 lines (108 loc) · 5.79 KB
layout title desc hide_show_for_marks hide_markbot extra_tutorials goal important steps
lesson
Peer evaluation
Get peers to evaluate your project, critique it, provide feedback and determine a grade.
true
true
title url
GitHub Issues
github-issues
before no_image notes
Get useful feedback from your peers on how to improve your project and a simple grade denoting how well you did.
true
label text
Honesty & politeness
This is constructive. Be polite & helpful. And honest.
title text
Rubrics & feedback
Use the most appropriate rubric you can find—there is a general rubric below if the assignment you are evaluating doesn’t contain a more specific rubric. Write helpful & valuable feedback—the rubric is a guide for what you’re looking for but it is not the final outcome. The written, helpful, improvement-generating feedback is what’s important.
title person before
Enable Issues on your repo
icon label
person-1
You
Before we start anything, you need to go to **your own** repository on [GitHub.com](https://github.com) and enable the Issues tab. **[Video on enabling Issues on GitHub repos ➔](https://www.youtube.com/watch?v=vTULg-7xycs)**
title person before
Find a peer
icon label
person-1
You
**Check the assignment requirements to determine how many peers should critique your work.** Ask the peer politely if they’d like to critique your project. If they accept give them the GitHub URL to the assignment for them to review. *Leave your peer alone so they can have time to consider and look at the project and write valuable feedback.*
title person before tasks
Evaluate the project
icon label
person-2
Peer
As a peer evaluator, it’s your job to help the other person succeed. You want to give honest, valuable feedback that will enhance and improve the other person’s project. *Write valuable written feedback & helpful criticism to help your peer improve their project.* ### Some things to consider:
Effectiveness of the usability
Effectiveness of the message
Quality of the project
Quality of the code
Creativity
Design execution
Spelling & grammar
title person before
Create an Issue
icon label
person-2
Peer
Create an Issue on the repository of the person whom you’re critiquing—this is where you’ll write the feedback. Write valuable and constructive feedback about their project. Be specific and polite. Think about how if this was your project what information you’d want. - Consider sending screenshots - Don’t forget about the [critique sandwich](https://www.wikihow.com/Use-the-Compliment-Sandwich-to-Critique) - Suggest ways to fix the problems --- ### Website URL to repo conversion ![](/courses/shared/gh-pages-to-repo.svg) 1. Cut the username 2. Remove the starting dot 3. Change `io` to `com` 4. Paste the username before the repository name
title person before code_can_copy code_lang code after
Fill out the rubric
icon label
person-2
Peer
In the same Issue, or in a comment, copy and paste the rubric and assign grades for the project you just reviewed. **If your assignment has a more specific rubric in the assignment requirements—use that rubric instead of the one below.** *The code will turn into a data table on GitHub when it’s previewed or saved.*
true
markdown
| | 0 points | 1 points | 2 points | 3 points | | --- | --- | --- | --- | --- | | **Creativeness** | Bland, boring | Fairly generic, but the colours are nice | Good, works very well and is unique enough | Wow! I never would have thought that would work so well! | | **Effectiveness** | I don’t know what this is trying to do | The message isn’t completely clear and it’s difficult to use | It’s obvious and simple to use | The project is super effective and easy to use | | **Quality** | Non-existent | Acceptable quality, more work could be done | Good quality, up to the expectations of the teacher | Stunning quality, this person rocks! | | **Effort** | Zero effort, incomplete | Decent amount of effort | Goodly amount of effort that shows | Amazing, over-the-top amount of effort | | **Code quality** | Barely started | Indentation is barely existent, lots of validation errors, very poor semantics | Decent indentation, just a couple validation errors, decent semantics | Well indented, fully valid, good semantics |
*Sum the rubric and put that value at the bottom.* *Confirm that you think this is an appropriate grade for the project you just reviewed.* **Write valuable written feedback & helpful criticism to help your peer improve their project. The rubric doesn’t help your peer improve, it’s only a mechanism to guide what you’re looking for. The written feedback is what’s important.**
title person before
Read the feedback
icon label
person-1
You
**Carefully read over the feedback from your peer and truely consider what they said.** Try not to take the feedback personally; separate your person from your project. They are trying to help your project succeed and improve.
title person before
Respond with a comment
icon label
person-1
You
Ask any questions of your peer, if anything is unclear. Don’t blame them. Don’t write excuses. *Remember they’re trying to help you—trying to make your project better.* **Write a comment thanking your peer for their feedback.**