Guide Details

Guide Details ¶ 

Guide Details make up the story behind the story. Tools, parts, prerequisites, and much more logistics-related information go here.

Block Image

Time Required ¶ 

Give people who follow your guide an estimate of how long this project will take. It's a good idea to be a little conservative with this estimate. It might take you less time to finish a project than it would someone who is attempting the task for the first time.

Difficulty ¶ 

Some procedures are fairly simple for any end-user—and others require years of specialized experience. Select a level of difficulty from the drop-down menu so you can give end-users an idea of how easy or hard the task will be.

Prerequisite Guides ¶ 

Each guide should be a completely independent step-by-step tutorial. And even if several guides follow some of the same procedures, we will help you avoid duplicated work. Use prerequisites to build on your existing guides.

Here's an iFixit guide for removing a MacBook battery. The battery removal guide is a prerequisite for the MacBook RAM guide. You can see that the first two steps of the MacBook RAM guide are actually the steps for removing the battery.

Effective use of prerequisites can be a huge time saver, but there are potential pitfalls. You can only use prerequisites for portions of the disassembly that are sequential. Let's consider an imaginary laptop. After researching the design of the device, we've concluded that the components can be removed in the following order:

1. Battery

2. RAM

3. Keyboard

4. Hard Drive

4. Optical Drive

4. Display Assembly

Notice that the hard drive, optical drive, and display assembly all share the same number. This means that once you've removed the first three components, you can choose to remove any of the next three. The hard drive is not a prerequisite for the optical drive because you do not have to remove the hard drive to take out the optical drive.

Here is a concrete example will help. On the MacBook, the optical drive guide shows how to remove the drive, along with its attached cable and brackets, from the computer. If you wanted to replace your optical drive, the optical drive replacement guide includes the details for removing the cable and brackets. You wouldn't want to use the optical drive replacement guide as a prerequisite, since there's no need to remove the cable and brackets from the drive unless you're replacing it. Prerequisites simply explain how to remove a component to enable access to other components (e.g. removing the optical drive is a prerequisite to replacing the lower case).

Advanced Prerequisites ¶ 

If a guide you want to use as a prerequisite does not belong in the same category as the guide you are writing, you can use a little wiki syntax to add it as a prerequisite. Simply locate the guide ID in the URL of the guide you would like to add as a prerequisite (hint: the guide ID is the second to last number in the guide URL). Now enter the the following wiki syntax directly into the prerequisite field: guideid:77. In this example the number 77 is the guide ID.

Block Image

Tools ¶ 

Any item or instrument that is required or recommended to perform your specific procedure constitutes a tool. Tools may be conventional (screwdriver, pliers, hammer, hacksaw, etc.), not-so-conventional (sickle, leather belt, kitchen utensil, etc.), or highly specialized (piston ring compressor, bicycle chain remover, tri-wing screwdriver, etc.). An easy way to determine if an item is a tool is to ask yourself, "Will I still have this item after this procedure?" If this answer is yes, then you've likely got a tool.

To add tools to your guide, click "Add a tool" and begin typing the name of the tool. You'll see a drop-down menu with a list of suggested tools to select. If the tool you want to add is not on that list, create a new tool to add to the guide.

Block Image

Provide a brief explanation of the tool that explains how and what it's used for. If it is an especially hard-to-find tool, you might want to provide a link to a site where the tool can be purchased.

After adding your tools, you may select "Edit Details" for each of the tools to add a type, change the quantity, or include notes. For a hacksaw, you may want to specify the number of teeth per inch, and in the note explain that cutting through metal requires more teeth per inch than a softer material like wood. You can go back and edit these details at any time by clicking the pencil icon next to the tool name on guide details.

Tools do not automatically import from prerequisite guides. Use the "Import tools from prerequisite guides" feature to add the tools from all of your prerequisite guides to your current guide.

Parts ¶ 

Whether you're building, fixing, or modifying something, chances are that the procedure is going to require parts of some sort. Parts—like tools—are important to completing the guide, but you can think of the parts as what makes the guide necessary. If you had no speakers or lights to install in your boom box, then there would be no need for a guide showing how to install them. Whereas tools are the items that you will still have after following the guide, parts are items that you probably will no longer have afterwards. Specific components, mechanical fasteners, adhesives, and lubricants are all parts.

To add parts to your guide, simply click the "Add a part" button and begin typing the name of the part you are adding. You'll see a drop-down menu with a list of suggested parts. If the part you want to add is not on that list, you have the option to create a new part.

Block Image

Provide a brief explanation of the part that explains what it does and where it goes. If it is an especially hard-to-find part, you might want to provide a link to a site that sells the part.

After adding your parts, you may select "Edit Details" for each of the parts to add a type, change the quantity, or include notes. For example, if your part is a quart of 5W-30 automotive engine oil, the type would be conventional or synthetic, the quantity might be 5, and in the notes you could tell others that 10W-30 is also an acceptable oil to use in warmer climates. You can go back and edit these details at any time by clicking the pencil icon next to the part name on optional details.

Conclusion ¶ 

Add a note to the end of your guide in the Conclusion. This can be a simple congratulatory statement, like "You did it!" or informational, like "To reassemble your refrigerator, follow these directions in reverse order." If you've said all you have to say, just leave this section blank.

Attach Documents ¶ 

Some procedures require additional documents, such as wiring diagrams or manufacturer's manuals. Add these documents by opening the "Documents" tab at the bottom of the Guide Details. Click the "Upload" button and select the documents you wish to add to the guide. Only PDFs can be attached to guides. After uploading the documents, attach them to the guide by dragging them to the indicated area.

Block Image

Bulk-Import Steps ¶ 

Just because you have written a great how-to guide outside of our guide creator doesn't mean that you have to start over on all that hard work. Bulk-Import Steps allow you to paste text from a webpage or text document and convert it directly to guide steps. The text should have some sort of structure, such as headings and line breaks for each step.

Example: You've already got a great write-up for telling people how to take long exposure photographs. Instead of starting over from scratch, you can click the "Bulk-import steps" button, and copy your text into the new field that appears. Bulk-Import Steps will take this:

Block Image

And turn it into this:

Block Image

Permissions Manager ¶ 

Permissions Manager is an administrator–only feature that keeps track of edits made by site members. Set the permissions threshold from 0 to ∞ for any guide by adjusting the slider to the right of the text window. Edits made to a guide by a user with a reputation lower than the permission threshold will be sent to the patrol queue for approval.

Tags ¶ 

What's the point of making a step-by-step how-to guide if no one will see it? Add pertinent tags to your guide and it will show up in more search results. Simply add the tags one-by-one, and then save them. Anyone may add, delete, or edit tags on a guide at any point.

Go back to the Help Index

Was this article helpful to you?
Didn't find the answer you were looking for? Ask a Question