wikiHow:Writer's Guide
One Methods:Standard Order for the Sections
This style guide is intended to help you create articles that match wikiHow’s format and tone. You’re writing for someone who has probably never completed this task before; who may or may not be covered in glue or dirt or baking powder as they frantically search the Internet for a solution to whatever how-to problem they’re facing. That’s why your articles need to be clear, concise, and (most importantly) informative.
Our overall goal with wikiHow writing is to provide skimmable information that readers can quickly understand while simultaneously creating rich, informative articles for more patient users. We’re trying to step away from the style of most traditional print publishers because readers of online content need to be able to comprehend information as quickly as possible. This means we’re going to throw some of the old rules out the window.
Remember: The advice below should serve as a guide while you’re writing. We realize there are exceptions to every rule, so keep in mind that nothing is set in stone, and always use your best judgment when creating or editing articles.
For questions, feel free to contact the Help Team, post in the forums, or e-mail our community facilitator, Krystle.
Choosing a Topic
You can write an article about how to do almost any topic (read our rules). It can be very broad (like How to Sleep Better) or very specific (like How to Sleep Better when You Have a Long Illness). Remember that your article, like the whole wikiHow site, is supposed to teach people how to do things. If a reader cannot complete the task you have provided the steps for, immediately or within a reasonable length of time, consider what your article would actually have taught them, and whether your proposed topic really is instructional. If you can't decide what to write about, try to answer a request instead.
If we already cover the exact topic you want to write, please edit the existing article instead of starting a new article. Since wikiHow is a collaborative project, we want people to work together to build one high-quality page on a particular topic, rather than each person making their own page.
Choosing a Title
Use the shortest title you can with the most common words to describe your article content. Be specific.
Begin the title with a verb. Remember, the words How to are automatically added for you. For example, instead of submitting "How to Bake a Cake", you would just write "Bake a Cake".
If you start an article with a mistake in the title, don't worry. Just insert {{title|new title}} at the very beginning of your article. Eventually a volunteer admin or a New Article Booster will see the request and change the title for you. It must be a suitable name for your article. It's best to check your title for mistakes before submitting it.
Introduction
The Introduction is where the reader decides whether those delicious-looking bacon chocolate chip cookies sound good enough to make. (Hint: They do.) It should be a brief rundown of what the reader will learn from the article, and the style and tone of the Intro may vary depending on the type of article you’re writing.
If the subject is fairly serious, such as in a technical or medical related article, the Intro should get straight to the point. You’re probably looking at two to three sentences max, and there won’t be a whole lot of fluff or filler. Check out “How to Treat a Sunburn” for an example.
If the subject is a bit more lighthearted, such as in relationship articles, you want the intro to be as approachable as possible. In these articles, people are probably reading to be entertained as much as they are reading for information, so we want to make sure to catch their wandering eyes and draw them into the article. Take a look at “How to Flirt” for an example.
Due to the layout of wikiHow pages, best practice is to avoid ending the introduction with broad calls to action like "Here's how," in favor of either open introductions or ones with a specific direction that helps readers find the start of the instructions, like "See step 1 to start the project."
Steps
-
1Put the most focus on your steps. Use them to keep readers engaged and make sure they get all the information they need.
-
2Start each step with an action-oriented instruction, such as “Put two cups of water into a medium saucepan." A good way to make sure you’re being active instead of passive is to double-check that each step begins with a verb. Also, try to avoid using words such as "Next", "Additionally", "But", and "If" unless they are necessary.
-
3Let the first sentence of the step summarize the entire action of that particular step. When you’re writing, imagine that a reader only skims these first steps, and ask yourself if the first sentences of the step would help them understand the basics actions of the how-to. If the answer is yes, you nailed it!
-
4Avoid using first person. Since we're a collaborative community, we try to refrain from putting I, me, my, etc. into articles, to make it clear that anyone can collaborate on the advice.
- Turn personal stories into instructions. Instead of writing "I put the heat up too high once and the eggs exploded" write "Keep the heat low or else the eggs might explode." You can share your personal experience with the topic on the discussion page for that article.
-
5Break long steps or long lists of steps up as needed. Readers respond best to main steps that are three to four lines long, and lists of steps that aren't so long they're overwhelming. However, if you find that one of your main steps, or the article itself, is looking a little lengthy, consider adding sub-steps or subsections to make it easier to follow.
- Use your sub-steps (the bulleted guys) as the supporting cast. They’re useful if you need to break one step into multiple parts or if there’s additional information that might help the reader accomplish the step.
- You can also use Parts or Methods subsections as needed to break things down when the article can be expanded beyond a simple few step process. Use "Parts" when all the sections are necessary to accomplish the goal and "Methods" when only one section is necessary to accomplish the goal (each section being a different approach for the same goal). See How to Divide a wikiHow Article into Subsections for information about making these subsection titles.
-
6Avoid explicitly referring to other steps, as the numbering of steps may change over time. For example, instead of writing “Repeat Step 1,” write “Repeat the rinsing process.”
-
7Remember that people from all over the world use wikiHow. Try not to include steps that can only be followed by people in one country unless your article title tells the reader who the steps are for. For example, keep in mind that different parts of the world experience different seasons (for example, in the southern hemisphere it's summer in December). Also, remember that certain brands of products aren't available in some parts of the world, so try to be as generic as you can.
-
8Avoid generic steps such as “Be patient and eventually your flowers will bloom” or "Have fun." Steps should be tasks that are vital to the completion of the project. One exception to this is the last step of an article where readers might want to see the finished product, as in a crafting article. In this case, the last step could just be the word “Finished.”
-
9Review your writing and try to make sure you are starting each sentence with a capital letter, and ending it with a period. If grammar and spelling are not your thing, don't worry too much. You or someone else can place a copyedit tag on the article and this will make sure it stays out of public view until someone comes along and fixes up the grammar, spelling, other issues.
Standard Order for the Sections
-
1Make sure that the sections are in the proper order and that all elements are gathered under the appropriate section heading:
- Introduction (2-4 sentences which draw the reader into the article proper. This section gets no heading.—Just start writing.)
- == Ingredients ==
- [[Category:CategoryName]]
- == Steps ==
- == Video ==
- == Tips ==
- == Warnings ==
- == Things You'll Need ==
- == Related wikiHows ==
- == Sources and Citations ==
- __MagicWord__ (Use Parts for sequential sections or Methods for independent ways to do the same thing. (This section gets no heading.))
Tips
- The Tips section should contain additional helpful guidance for the reader about how to perform the how-to. Tips can do a number of different things:
- Extend information presented in the Steps section: “To make sure your cake is done, insert and remove a toothpick. If the toothpick comes out clean, the cake is ready.”
- Inform readers about alternatives that can be used: “A tablespoon of olive oil can be substituted for the butter in this recipe.”
- Offer other helpful non-step information that is not appropriate elsewhere.
- The Tips section is not appropriate for:
- Personal opinions on the article topic.
- Comments such as “Enjoy!!” or “Have fun!”
- Repeating information that you’ve already discussed.
- When you are editing, do not use the tip section as a comment section or a spam section.
- Personal information.
Warnings
- Use the Warnings section if it’s necessary to alert readers to serious problems they might encounter when completing the task, such as threats to life and limb or major costs that might be incurred. Not every article will have a Warnings section, but if you’re trying to move past that knife-throwing article without one, we would suggest re-thinking your approach.
- Avoid obvious warnings such as “Be careful not to cut yourself with the scissors.”
Things You'll Need
- In the Things You’ll Need section, include all physical items necessary to complete the task (e.g., scissors, needle, thread). Do not include non-physical needs (e.g., perseverance, time).
- Be as concise and specific as possible. Do not include items that are probably obvious or already available to the reader. Often, this section will just be a list of items.
- See How to Add the Things You'll Need Section to a wikiHow Article for more information.
Ingredients
- If your article needs an Ingredients section, it should go at the top of the article, below the Intro and above Steps. Include all the edible items that are necessary for the article, as well as their measurements in both metric and imperial. Non-edible items, such as pans, utensils, tools, or machines (eg. fridges), should be listed under Things You’ll Need.
Sources and Citations
- We want readers to feel confident about the accuracy of the information we’re presenting on wikiHow, and that’s why we place a huge emphasis not only on sourcing, but also on choosing reputable sources.
- Avoid using personal blogs and Web forums as sources unless they’re run by reputable organizations (e.g., a professor’s blog linked from his university website, or a software expert’s personal site). We realize that for lighter topics, such as cooking or crafting, there are a lot of respected individual blogs, and those are totally fine to use; just make sure your sources look professional and are free of egregious errors. Also avoid websites such as eHow, Yahoo Answers, Ask.com, Examiner.com, or other sites where you suspect that a vibrant fact verification process does not take place.
Using the Sources and Citations Section
-
You aren’t required to use any sources or citations in your articles, but using in-text citations can boost the credibility of what you have written, especially if your source is well regarded and enables readers to dig deeper if they want more information about what you've written.
- For that reason, we encourage you to include in-text citations for anything you write that has supporting source material. To do this, use the <ref>http://www.example.com</ref> format, listing the source (either a link or reference to a printed work) at the end of the line or section to which it relates. When you add {{reflist}} at the bottom of the article, in the Sources and Citations area, this automatically puts whatever is between the <ref>______</ref> tags into a footnote in that section.
- Refer to "How to Reference Sources on wikiHow" for complete information on how to format in-text citations.
- We recommend you do not add hyperlinks to outside sources within the text, as in-text citations are far more likely to be kept with the article. Hyperlinks to external sources within the main text, however, will often be changed or removed by editors, especially if they are intended to pull readers to another site - they have too often been inserted by spammers in the past.
General Guidelines
Brand names
- Avoid referring to specific products whenever possible. For example, in an article about how to clean up spills, recommend that readers use cloths or paper towels instead of Scotch-Brite™ Kitchen Wipes.
- There are two exceptions to this rule:
- When your article talks about how to use a specific product, such as in “How to Create a Graph in Microsoft Excel”
- When there is no alternative to a brand-name product (e.g., Rogaine)
Measurements
- To accommodate wikiHow’s international audience, always refer to both imperial and metric measurements: “Walk one mile (1.6 km) every day.” Other good practices include using general phrasing like "Call emergency services" instead of "Call 911."
- Click here for a good wikiHow article about how to convert imperial measurements to metric measurements and use weights instead of volume.
Article Info
Categories: Help | Writing and Editing
In other languages:
Deutsch: Wie man einen wikihow Artikel schreibt, Español: Guía del escritor, Français: Guide de l'auteur, Italiano: wikiHow:Guida degli Autori, Nederlands: Schrijf Gids, Português: Guia do Escritor
Thanks to all authors for creating a page that has been read 293,191 times.