Using Wikibooks/Wikipedian Primer

< Using Wikibooks

Wikipedia is an important sister project for Wikibooks, and many of our editors started as Wikipedians before coming to Wikibooks. Despite the many similarities between the projects, especially software-related similarities, there are a number of subtle differences between the two projects that could confuse Wikipedians at first. This chapter is designed to be a quick start guide for incoming Wikipedians, to help them acclimate to the Wikibooks project quickly.

Textbooks vs. Encyclopedia Articles

It should be obvious that a "textbook" and an "encyclopedia" would be different things, and online this difference is the same. While an encyclopedia is tasked with providing information, a textbook must instruct the reader, and teach that information in a way that a reader can learn. For the same size of a page, a textbook will typically contain much less information, but much more explanation and instruction.

Textbooks on Wikibooks should also be structured similarly to traditional textbooks. Books have a table of contents, and the book content is separated into chapters and then pages. Some books may only have pages, not chapters. Some books will use other layers of organization such as "units", and "subchapters". This much is left up to the discretion of the author. However, the important part is that books are organized hierarchically, with the "book" being the top of the hierarchy, and the "page" being at the bottom. Because of the hierarchical structure of books, and the self-contained nature, our textbooks tend to use hyperlinks less extensively than articles on Wikipedia do.

Wikibooks textbooks may also include other components of a traditional book such as:

Cover pages
Pages with the title of the book, a cover image, and some brief information
Prefaces
A page, written by the authors, about the book
Glossaries
Pages for defining terms and phrases used in the book
Appendices
Pages that contain information that is ancillary to the central narrative of the book, but which is important for the proper understanding of the material

Organization and structure are not enough to differentiate a book from an encyclopedia article, however. The pages in a textbook should be interrelated to each other, usually with a predefined reading order, and a unified narrative that builds from page to page. A textbook is not a macropedia, a collection of several related encyclopedia articles. Some books however, such as the Cookbook are structured as a collection of pages, although this should be considered more of a rare exception than a rule. If a book does not have a specific reading order and a central narrative, it must at least be instructional.

"Bookify" and Book-Like Formatting

Many books start out as encyclopedia-like articles, or as macropedias. While a macropedia is not an acceptable textbook, it is common and acceptable for some books to be structured like a macropedia during development. There are several reasons for this. First, many books are created by importing articles from Wikipedia to use as a basis for the new book. Second, it is often easier to write information down first and then organize and revise it later. Writing a central narrative for a book can be difficult in the early stages of development when the reading order of the pages is not finalized. Macropedias that are early in development will be marked for cleanup. Macropedias that are old or abandoned may be nominated for deletion.

As we mentioned above, pages in a Wikibooks textbook tend to use links very sparsely. There are a few reasons for this. First, books really need to be self-contained. Relying on too many links means that your book isn't covering the material as well as it should. Also, external sources are unlikely to be as instructional as a textbook. Second, having to follow too many links, or following links in mid-sentence can be distracting to readers, and can prevent them from following the narrative of the book, and learning the lessons adequately.

Creating red links on Wikibooks, by putting [[brackets]] around [[common]] [[words]], like is done at Wikipedia is unlikely to create a viable link to an existing Wikibooks book. Converting these links to point to Wikipedia using piped syntax is more difficult to do, harder to maintain, and makes the source code of the page harder to edit. Also, interwiki links are unreliable, as we at Wikibooks have no control over whether Wikipedia articles are moved, or deleted, or disambiguated. Having pages full of such links can make maintenance a nightmare.

This is not to say that linking to Wikipedia or one of the other sister projects is a bad thing. However, use links sparsely, and only direct people to the articles that are the most pertinent and most important to support the discussion at hand. To include a link to Wikipedia, you could use the {{Wikipedia}} template. If you would like to link to several articles, you could use a page at the end of your book for "Resources", or a "Bibliography", or something similar. There are plenty of places to put links to reference Wikipedia or any other website, but typically they need to be used sparingly within the text of your book.

Wikipedian FAQ

How you can help

This article is issued from Wikibooks. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.