- Is the device page URL capitalized and punctuated correctly with no extra descriptive words, such as “laptop,” “printer,” or “camera”?
- Is the image used for the device picture well-lit, clear, the correct 4:3 aspect ratio, and above all, a photograph taken by the group members? Was the full-size image from the camera uploaded?
- Did the group make proper use of headings and include all of the necessary sections of the device page?
- Is there thorough information describing the device and its history to educate readers and aid them in identifying their device?
- Did the group provide at least three helpful links on the device page that a user would find useful when looking for information on their device?
- Did you post and answer three questions about your device?
- Did your three support questions automatically show up on your device page under the "Support Questions" section?
- Did you include links within your solutions to direct users to your troubleshooting page?
- Is the device page free of major errors in grammar, punctuation, and spelling?
Email Us When... ¶
...you have finished your device page. 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. The 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.
- Support questions about the device.
It may look daunting at first, but a good portion of this information is generated automatically. Let’s break down what you’ll be doing.
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 you used for the troubleshooting page that you created for Milestone 1, and 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 pane 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 be prompted to crop it using our built-in tool when you upload it.
- The most important thing to remember is to take your own device page picture, rather than taking one from an online image search.
- 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 will 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.
Support Questions ¶
The best way to drive interested readers to your guides is by way of the Answers forum of the site. Answers allows users to ask the iFixit community for help by posting questions about their broken device. Your final task for the device page is to seed this section with several "starter" questions, asked from the perspective of a frustrated user, and then answer them. Lucky for you, you have already generated all of this content, so this part of the project will be simple.
Here is how you will create your support questions:
- Choose the three most likely questions. Look through your troubleshooting page and decide which three of the symptoms are the most likely to occur.
- Post the questions. Simply click the "Ask a Question" button on your device page. (Alternatively, on the top of any page on iFixit.com, click on the Answers tab. Then click on "Ask a Question" on the top right side of the page.) Then, fill in each of the following sections.
- Device: The device name, EXACTLY as it appears on your device page. (If you clicked the "Ask a Question" button directly from your device page, this field is filled in automatically and should not be changed!)
- Short, descriptive question: Type your troubleshooting topic in the form of a question. (For example, "Why is my device not turning on?")
- Description: Elaborate on the question. Explain what sort of symptoms you observe in a device with this problem, exactly as if you were a real user experiencing this issue.
- Have a different group member answer the questions. Once you have posted all three of your questions, have a separate teammate log on and answer each question! Include full descriptions of how to solve the problem, as well as a link to your troubleshooting page.
- Finally, accept the answer. The team member who originally posted the question should mark the answer accepted, to indicate that the solution worked.
Device Page Tips ¶
Changing Device Page Name ¶
Once you create a device page, you can't simply change the title because the page's URL has the title in it. "Changing" the title involves creating a new page with the correct name first, copy/pasting all the information from the old page, and then deleting all the information from the old page. If you're planning to change the name:
- Copy all the text from the old page.
- Create a new device page with the new name you want.
- Paste the old content to the correctly named page.
- Delete the old page.
Deleting Device Page ¶
If you find yourself needing to delete a device page, follow these steps:
- Go into edit mode by clicking the Edit link in the top-right corner of the device page.
- At the bottom left corner of the page, select the "Delete Device" link with a trash can icon.
- A pop up will say "Are you sure you want to delete the entire page?".
- To continue and delete the device page, select "OK".
- The page should now say "This device repair manual does not exist yet, but you can start it now!".
Migrating Guides To New Device Page ¶
If you already have some replacement guides started, moving them to a new device page is easy:
- Go to the Edit screen for the replacement guide.
- Change the text in the Device field to the correct device name.
- Click the save button.
- The guide should now be correctly associated with the new device name.
Example Pages ¶
The following examples from past projects give a good idea of what your completed device page should look like.
Focus On: Repair Culture ¶
Our world needs fixers now more than ever. Bolstering repair culture across the globe will create jobs and conserve our limited resources.