Milestone 2: Overview
In Milestone 2, you will create a device page. A device page acts like a homepage for all of your other guide pages and helps readers identify their device.
When you finish this milestone you should have completed the following:
- Correctly capitalized and punctuated the device page title with no extra descriptive words, such as “laptop,” “printer,” or “camera"
- Used an image for the device page that is well-lit, clear, the correct 4:3 aspect ratio, and above all, a photograph taken by the group members
- The full-size image from the camera should be uploaded.
- Made proper use of headings and included all of the necessary sections of the device page
- Included thorough information describing the device and its history to educate readers and aid them in identifying their device
- Provided at least three helpful links on the device page that a user would find
- Written a device page free of major errors in grammar, punctuation, and spelling
Email Us When...
...your device page is complete. We’ll be happy to look it over and offer feedback!
A device page serves as the hub of all the repair information about your device, including background and identification, links to replacement guides, and a link to your troubleshooting page. This screenshot of a completed iPhone 5 device page is a good example of the appropriate length and amount of information you should provide.
Your completed device page should contain the following:
- A picture of the device taken by your group (not one found online).
- A short summary of the device.
- A link to your troubleshooting page.
- Background information on the device (such as its major features/components, release date, known failure modes, manufacturer recalls, etc.) and how to identify the device (i.e. How is it distinguished from similar devices/models?).
- Three or more links to the best online resources for the device.
It may look daunting at first, but a good portion of this information is generated automatically. We break it all down for you on the next page.
The following are A-level device pages from past student projects. Use these for inspiration, but don't try to copy them exactly—that is, they've been published on iFixit for a while, so they've accumulated more content than you're responsible for.
Creating Your device Page
- Start a new page by clicking here.
- If a device page already exists for your device, you shouldn't create a new one. Simply send us an email, and we'll flag the existing page so you can work on it.
- Select "Device" from the list of options.
- Enter your device name in the Title field.
- The device name should exactly match what appears on the white iFixit label on the device. If you didn't get your device from iFixit, the name should be the same as what appears on the manufacturer's website or in official documentation (owner's manual, etc.)
- If your device is known by more than one official name, stick with the most common one (Google Trends can be helpful here). Alternate model names/numbers can go in the summary (see below).
- Do NOT include the device type or generic terms such as “laptop,” “cell phone,” etc.
- Be sure to spell and capitalize your device name properly or your replacement guides will not link correctly.
- Upload a picture of the device by clicking on the camera icon in the panel on the right-hand side of the page. The device page picture is the first thing users will notice when they navigate to your device page, so it's important that you take a quality photo.
- Take the picture with the device against a solid white background that is well-lit, with the camera in landscape orientation.
- Keep your pictures as large as possible in terms of resolution. If a picture is 4000 x 3000 pixels in size, so be it! We love large images.
- If you're using a DSLR or other camera that captures images in an aspect ratio other than 4:3, you’ll need to crop your photos to 4:3.
- The most important thing to remember is to take your own device page picture, rather than taking one from an online image search.
- Please do NOT use Photoshop to remove photo backgrounds. Your backgrounds don’t have to be perfectly white; a nice uncluttered background is less distracting than one that has been crudely cut out. Even if you really, really know what you’re doing, your time is better spent on other parts of the project.
- If you're working on a preexisting device page that already has a photo, you should check with us to see whether a new photo is needed. Just drop us an email!
- Enter a short, descriptive summary. The summary should be 1-2 sentences, and should give the most basic identifying information about the device. Remember that summaries are used in search results, so include key words or phrases you think your readers might search for when looking for help. This is also a good place to include alternate model names/numbers, if any.
- Please do not include a table of contents—it's helpful on longer, text-heavy wikis like the troubleshooting page, but it's not needed for your device page.
- Add the Troubleshooting, Background and Identification, and Additional Information headers and their content in the main text box. To create a heading in wiki syntax, simply enclose a word or phrase in double equal signs (e.g. == Troubleshooting ==). Follow the format outlined in this example device page.
- Troubleshooting This section should be a single sentence linking to the troubleshooting page you created in Milestone 1.
- Background and Identification This section should include one or two paragraphs of info on the device (such as its major features/components, release date, known failure modes, any manufacturer recalls, etc.) and how to identify the device (including how to tell it apart from similar models).
- This, like all of your work, should be written completely in your own words. Although you may find websites that have great descriptions of your device, do not copy and paste these descriptions into your device page, as this is plagiarism. Of course, you’re free to use these websites for reference (don’t forget to credit the source).
- Additional Information This section should include at least three helpful links to the best online resources for the device. You can link to any helpful source of information, such as other replacement guides, the device’s Wikipedia page, the manufacturer’s device page, product reviews, etc.
- All links on your page should be formatted using wiki syntax. (Use clickable words or phrases, rather than long scary URLs.)
The only sections of your device page you need to create manually are Troubleshooting, Background and Identification, and Additional Information. Do not create any Guides, Parts, Support Questions, or Tools sections—these sections will be added to your device page automatically when you create the additional content (just remember to keep the spelling of your device consistent). In addition, some groups may choose to manually create Upgrades and/or Specifications sections; this can be helpful if it's appropriate for your device, but it's not required.