- Is your device reassembled?
- Have all pictures have been uploaded to the site?
- Have all guides been linked to the appropriate prerequisite guides?
- Has all text been reviewed at least twice, to make sure it is correct for group review?
- Has all necessary markup been added to pictures?
- Have all bullets been reviewed, to ensure all appropriate bullet types have been chosen for caution/note bullets?
- Have you provided written feedback for each part of another group's project that did not follow the peer review checklist?
- Have you added flags that address each problem with the guides?
Email Us When... ¶
...you have finished your project. We’ll be thrilled to publish your guides for all the world to see! Include any feedback you have on the project! We always want to improve the program for future students.
After completing the rough drafts for all of your replacement guides, you will give your device to another group from your class and your guides will be reviewed. Be sure to reassemble your own device before giving it to another group for review. Likewise, you will obtain another group's device and review their guides. Use this checklist to thoroughly examine the other group's guides and to provide them feedback on any improvements they may need to make.
Peer Review and Feedback ¶
Peer review is a form of usability testing, or testing a document to see if it is effective—in this case, to see if users can easily and successfully follow your guide. Usability testing provides an opportunity to find any problems or issues with your guides before they are released.
When you are reviewing other students’ content, it is important to keep a few things in mind:
- Only give constructive feedback!
- Point out both corrections and things that were done well.
- Be as specific as possible, citing specific steps and offering suggestions for changes.
- Point out anything that is confusing or ambiguous.
- Use this checklist to evaluate the guides for technical accuracy.
Adding Flags ¶
In addition to providing written feedback for the group, you will also add flags to their guides. Flags show up at the top of the guide explaining what things need to be fixed. To add a flag to a guide:
- Go into that guide's Edit tab.
- Scroll down to the bottom, and select a flag from the drop-down menu below the Flags section.
- Choose whichever flag is most applicable to the problem that you observed with the guide. You can add as many flags as necessary to a guide, and they can be deleted once the group fixes the problems.
- When you add a flag, you should also write down which flag applies to which step(s) to make sure that the group knows exactly where the mistakes are.
Final Guides ¶
- At this point, any changes from the peer review should have been made, and all pictures/text/markup should be complete and ready to turn in.
- After making peer review changes, you can delete the corresponding flags from the guide by going into the Edit tab and clicking Remove next to the corrected flags.
- DO NOT remove the "In Progress," "Student Guide," or "User-Submitted Guide" flags from your guides. We will remove these when we publish your guides.
- Both the device page and troubleshooting page should be complete and ready to be scored.
- Finally, send us an email once all your work is submitted to let us know that you are finished—and if you’d like some final feedback from iFixit’s tech writing team, be sure to let us know. Lastly, don’t forget to send us your own feedback about the project!
Focus On: Right to Repair ¶
We hope that through this course you've not only learned technical communication and repair skills, but also why repair is more important than ever. Here at iFixit, we believe that you have the right to repair all your devices, regardless of any manufacturer's red tape. If our mission resonated with you, we'd love for you to continue to contribute to the repair community, take the pledge to repair the broken things in your world, and to stay up to date with our's at the iFixit blog.