guide creation


  • Click the “Create a Guide” button on your device page.
  • For guide type, choose “Replacement.” All your guides should be replacement guides for your device’s components, unless you’ve made arrangements in advance to do something different.
  • Don’t change the text in the “Device” field. This is filled in automatically and must exactly match the name used on your device page. If this text is altered, your new guide won’t show up on your device page.
  • Type the name of the component you’ll be replacing in this guide in the next field (Battery, Display, etc.).
  • Don’t change the guide title unless you notice a problem. This field is filled in automatically based on your earlier selections. It should only be changed if the auto-generated title doesn't convey what the guide is doing.
  • Write a short summary for your guide. The summary is used in search results, so keep it brief (one or two sentences), and include any terms or phrases that your readers would be likely to search for. A good example of a summary might be, "Replace your dying battery to bring the power back to your iPod."
  • Click the “Show More” button. This brings up some additional fields for your guide.
  • Write a short introductory paragraph for your guide. The introduction should contain any background information a reader would need before they begin. Think about what you would tell a friend before doing this guide: any special requirements, hazards, why this repair might be needed, etc. This is also a great place to add any corresponding information from your troubleshooting page.
  • Leave the “Flags” section alone for now. At the bottom of the page, you may see some auto-generated "In Progress" or “Student In Progress” flags that mark your guide as being part of a student project. Don’t try to remove them! We’ll do more with flags in Milestone 4.
  • Click “Save.” Congratulations! You’re ready to start your guide, and will now be taken to the Edit page for the first step.


Don’t work on the same step at the same time as your teammates. It's okay for multiple team members to work on the same guide at the same time, as long as each team member works on different steps. If more than one team member tries to edit the same step at the same time, they may overwrite each other's work.

Keep the “Public/Private” option set to Private. We’ll publish your guides after they’ve been reviewed and scored.

Your guides and activity will be visible on your team's page. You can view your team activity by logging into, clicking on your name in the upper right-hand corner of the page, and selecting "My Team."

Don't worry about adding step titles. Even though your guide steps say "Add A Title," students actually don't have the necessary privileges to edit them.