Help:Wikipedia: The Missing Manual/Introduction

From Wikipedia, the free encyclopedia
Wikipedia: The Missing Manual (Discuss)

Wikipedia: The Missing Manual is a how-to guide that explains the process of contributing to the English Wikipedia, both for novice users and experienced editors. It was originally written in 2008 by John Broughton, but has since been expanded and updated by many other Wikipedia contributors.

Wikipedia has a myriad of pages documenting policies, guidelines and processes. It's hard to know where to start to learn about contributing to Wikipedia. That's what this book is for: It provides a clear learning path for the essentials, and tells you where to read more if you need it.

About Wikipedia[edit]

Wikipedia formally began in January 2001, as a project to produce a free content encyclopedia to which anyone can contribute. Eight years later, Wikipedia pages seem to turn up near the top of almost every Google search. Wikipedia has become the first place millions of people go to get a quick fact or to launch extensive research.

Editions of Wikipedia exist in more than 300 languages, with a combined total of more than thirteen million articles. All the editions use the same underlying software, MediaWiki. All are owned and supported by the Wikimedia Foundation, a nonprofit organization that also operates a number of other online collaborative projects, including Wiktionary, Wikiquote, Wikibooks, Wikisource, Wikispecies, Wikinews, Wikiversity, Wikivoyage, and Wikidata.

Each language edition of Wikipedia operates separately, almost entirely through the efforts of tens of thousands of unpaid volunteers. The Foundation has 350 employees,[1] including several programmers. It buys hardware, designs and implements the core software, and pays for the network bandwidth that makes Wikipedia and its sister projects possible, but it doesn't have the resources to do any of the writing for those projects. All the writing and editing are done by people who get no money for their efforts, although plenty of intrinsic satisfaction.

Wikipedia has never lacked skeptics. Why expect quality articles if everyone—the university professor and the 12-year-old middle school student—has equal editing rights? Won't cultists and fringe theorists and partisans take control of controversial articles? Won't vandalism become rampant, driving away good editors? How can tens of thousands of people work together when there is no hierarchy to provide direction and resolve disputes?

These questions point out the inevitable disadvantages of the "anyone can edit" approach to creating an online encyclopedia. Wikipedia will always be a work in progress, not a finished product. What the skeptics overlook, however, is that letting anyone edit has proved to be an incredible strength. In a world where a billion or so people have access to the Internet, millions of people have contributed to Wikipedia, and their numbers are increasing every day.

As a result, the vast majority of the millions of articles in all the different Wikipedias are of at least reasonable quality although many are quite short. The domain is among the most visited on the Internet, because there's no free alternative for most of the information in Wikipedia. The critics' predictions that Wikipedia's limitations will cripple it have not come true.

What makes Wikipedia so successful? Here are some of the reasons it works:

Figure 0-1. Editors express the great feeling editing Wikipedia gives them.
  • An overwhelming percentage of the edits to Wikipedia are done in good faith—that is, by people trying to improve articles, not vandalize them. People edit Wikipedia from the pure motivation that it gives them a great feeling
    (see Figure 0-1)
    . When vandalism occurs, it is usually reverted quickly because there are so many constructive editors around to fix it.
  • Wikipedia has a large number of rules about its process that encourage collaboration and build consensus around what information goes into articles. When people follow these rules, quality articles are the result.
  • An overwhelming percentage of editors do follow the rules, and when others point out their mistakes, they're willing to self-correct. Those editors who do find Wikipedia rules to be problematical typically leave on their own.
  • Finally, there are a few editors with special authority to enforce the rules. This authority is granted by the community of users, through agreed-upon processes. So far, the enforcers have been adequate for the job, helped by increasing automation of many routine administrative tasks.

The success of Wikipedia may seem surprising. There's that famous pseudonymous quote by the Slashdot user geekoid, "the problem with wikipedia is that it works in practice, but not in theory."[2] It's true that a naive application of a theory like the tragedy of the commons would predict failure. But in the case of Wikipedia the inverse outcome is observed because the cost of a contribution is much less than its value over time. For example, it costs very little time (and no money) for a contributor to add information to Wikipedia, and it costs relatively little for Wikipedia to serve that information over and over again to readers, generating great value over time. Unlike the pasture of a physical commons, information isn't degraded when it is used. Thus the value of Wikipedia increases over time, attracting more readers, some of whom become contributors, forming a virtuous cycle.

As Wikipedia grows, its focus is likely to continue to change. Wikipedia already has articles covering most of what its readers think are important topics. (For exceptions, see WP:EIW#Missing.) So the focus is shifting away from quantity and towards quality—improving articles rather than creating new ones. As the definition for success shifts, Wikipedia's processes will adjust as well. The consensus approach has proven flexible enough, so far, to deal with problems as they arise. Emphasizing quality—in ways that affect most editors' everyday editing—will be one of Wikipedia's biggest challenges.

About this book[edit]

This book is about the English edition of Wikipedia—the oldest, largest, and most complicated edition of Wikipedia, but not (since March 2001) the only edition. In other words, this book is about the domain, not the entire domain. For simplicity, when you see the term "Wikipedia" on this page it refers to the English edition of Wikipedia. Just remember that other language versions exist.

Why do you need a book about editing Wikipedia? Wikipedia certainly doesn't lack for pages that document policies, technical matters, instructions, and agreed-on processes. Wikipedia depends on volunteer editors to write and update virtually all the documentation for Wikipedia and its underlying software, and plenty of editors enjoy doing this valuable work. If printed out, Wikipedia's online reference pages would make a multivolume set of books that might be titled Everything you might possibly want to tell millions of volunteers from around the world about how to write an encyclopedia, together, including how to organize and govern themselves, and how to change the software that underlies the encyclopedia, avoid legal pitfalls, and enjoy themselves.

What's missing, however, is structured guidance for people who want to learn the "core curriculum," the information you absolutely need to avoid running afoul of the rules, and a structured process for learning all about editing, including all the tips and tools that can make editing easier. Wikipedia doesn't offer anything that charts the path from novice to expert, with step-by-step illustrations for every topic along the way.

For example, there are dozens of pages in Wikipedia that describe the three different processes for getting an article deleted. There are no designated pages for novices and experienced editors, and there's no editorial board responsible for maintaining consistency and deciding how much duplication is appropriate. Newcomers to Wikipedia often find the large collection of massively hyperlinked online reference pages intimidating. With so many entry points, it's hard to know where to start.

This book provides a clear path to all the essentials, with numerous additions to choose among. Tens of thousands of Wikipedians have gotten off to a rough start, yet persevered, going on to become solid contributors. This book helps you learn from those mistakes without having to personally live through them.

Wikipedia: The Missing Manual is designed to accommodate editors at every level of experience. If you're just starting out, that's fine: The early chapters will make your editing experience more productive as well as enjoyable. Nor do you have to be a computer whiz. The really great editors are good at one or more of several things, including research, editing and writing, organizing, and working with other editors; technical matters are simply one realm of specializing as a Wikipedia editor.

If you've already done quite a bit of editing of Wikipedia, and learned—by trial and error as well as reading documentation—what to do and not to do, even the earlier chapters are likely to offer you useful tips and tricks. In the later chapters, you'll learn about things you've never run across before, simply because you've never had time to read through all the Wikipedia documentation. Check out the table of contents to spot unfamiliar aspects of Wikipedia, so you can turn immediately to the parts of the book most likely to help you work better and faster.

About the outline[edit]

Wikipedia: The Missing Manual is divided into six parts, each containing several chapters.

  • Part 1: Editing, creating, and maintaining articles, covers the basics. These chapters explain the right way to edit, why you want to be a registered editor, how to become one, and everything you need to know about figuring out, tracking, and reversing changes to articles when appropriate. It also discusses all the things to do when creating a new article.
  • Part 2: Collaborating with other editors, discusses the rules of engagement, how normal conversations occur, the standard Wikipedia processes for disagreements over content, and dealing with incivility and personal attacks. This section also covers what Wikipedia calls WikiProjects—groups of editors working on articles of common interest, plus the wide range of activities that go into expanding and maintaining a huge encyclopedia: answering questions, tutoring and mentoring, joint reviews of articles, and more.
  • Part 3: Formatting and illustrating articles, introduces you to some parts of articles that aren't text or links: the table of contents, lists and tables, and images and other media. Much of this can be confusing when you first encounter it, but each topic has a logic that makes it easy to understand once you've worked with it for a bit. (And you always have this book as a reference!)
  • Part 4: Building a stronger encyclopedia, looks at the larger picture. It shows you that an article isn't locked in stone—you can rename it, split it up, merge it with other articles, or even ask for it to be deleted. Naming and merging are ways of getting readers to the information that they want. Another way, covered in this part, is Wikipedia's system of categories, one of several ways to find and navigate between articles.
  • Part 5: Customizing Wikipedia, discusses every option that you have to customize Wikipedia to suit yourself, using choices you find when you click My Preferences. You'll also learn how to implement JavaScript user scripts (which you'll see mentioned in the some boxes in this book).
  • Part 6: Appendices, provides you with resources to make the most of Wikipedia, as a reader, editor, and member of the Wikipedia community. Appendix A: A tour of the Wikipedia page is an explanation of every link and tab for standard Wikipedia pages (in both reading and editing mode). Appendix B: Reader's guide to Wikipedia, provides some insider tips for those who simply want to read Wikipedia, and want to know what's available besides Wikipedia's search feature and following links in articles. Appendix C: Learning more, provides good starting points to get you as an editor to exactly the reference page you're looking for, lists the places in Wikipedia where you can get personalized help, and shows you where you can find out about Wikipedia as a community.

The very basics[edit]

You'll find very little jargon or nerd terminology in this book. You will, however, encounter a few terms and concepts that you'll encounter frequently in your computing life:

  • Clicking. This book gives you two kinds of instructions that require you to use your computer's mouse or trackpad. To click means to point the arrow cursor at something on the screen and then—without moving the cursor at all—to press and release the clicker button on the mouse (or laptop trackpad). To double-click, of course, means to click twice in rapid succession, again without moving the cursor at all.
  • Wikipedia doesn't use menus. On Wikipedia pages, links to pages, and links that trigger a particular action (such as opening an article for editing) are found along the top and left of the screen, not in menus. These can change; what you see depends on the type of Wikipedia page, and whether or not you're logged in. In addition, the content of a page may have links, typically to content on other Wikipedia pages. Appendix A: A tour of the Wikipedia page covers the links and actions at the top and left of your screen.
  • The search box on the top-right of the screen is the primary way to go to any page for which you can't see a link. For example, entering elephant and pressing Enter sends you to the Wikipedia article titled Elephant. If you use this book a lot, you'll probably use the search box a lot—you may find it's worth memorizing the keyboard shortcut to get to it (see the 'Keyboard shortcuts' section). Or you can simply bookmark this book's homepage, and open it in a separate tab whenever you are on Wikipedia, for quick reference.
  • Most of the reference pages that discuss policy, guidelines, how-to, and so on, have an abbreviation ("shortcut") that you can use to quickly get to that page. For example, rather than type Wikipedia:Verifiability (23 characters), you can just type the shortcut WP:V (only four characters), and then press Enter or click Go. In the early chapters, the search box will be explicitly mentioned; in later chapters, the book will normally just mention the shortcut name, assuming you're familiar with using the search box to get to a specified page.
  • Wikipedia uses special markup text in its MediaWiki software. For example, to set up a link that points to another page within Wikipedia, you put paired square brackets around a word in editing—thus [[elephant]], for example, entered in editing mode, would be "elephant" as a link once an edit has been saved. Chapter 1: Editing for the first time on basic editing explains markup text.
  • Articles and pages are different things. Readers are interested in article pages and, to a lesser extent, category pages and portal pages. Wikipedia has many other types of pages: template, image, and user pages, for example—and talk pages for every type of page (see the section about talk pages).

Mac OS, Windows, browsers, and keyboard shortcuts[edit]

Wikipedia works in all modern Web browsers on Windows, Linux and Macintosh computers. The screen may look slightly different from the illustrations in this book, depending on your browser. The screenshots in this book were taken while using Firefox and Opera, on a computer running Windows XP.

The tutorials and other instructions in this book don't use keyboard shortcuts, because shortcuts vary not only between operating systems but between browsers (Firefox 1.5 vs. Firefox 2.0 vs. Opera, for example, in their Windows versions). If you like using shortcut keys, see the details in Appendix A: A tour of the Wikipedia page (in the 'Keyboard shortcuts' section) on how to learn them.


In this book you'll find sentences like this one: "Go to Tools→Preferences→Advanced tab." That's shorthand for a much longer instruction that directs you to navigate through menu commands and dialog boxes, like so: "Click to open the Tools menu; choose Preferences. In the Preferences dialog box, click the Advanced tab." This kind of arrow shorthand helps to simplify the business of choosing commands in menus.


  1. ^ "Staff and contractors page (Wikimedia Foundation website)". Wikimedia Foundation. September 21, 2017. Archived from the original on June 2, 2016. Retrieved August 8, 2018.
  2. ^ geekoid (March 10, 2006). "Re:Sustainability". Slashdot. Geeknet, Inc. Retrieved November 23, 2011.