Wiki4Games:Style guide

From Wiki4Games
Revision as of 20:17, 30 May 2011 by Patheticcockroach (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Help Style guide Wanted pages Categories All pages Recent changes News Community portal

This style guide has the simple purpose of making the Wiki4Games easy to read by establishing a certain format. One way is often as good as another, but if everyone does things the same way, the articles will be easier to read and use, along with being easier to write and edit. Reading the style guide is important to ensure that each user's edits will be consistent with those of other users.

Contents

Content > Style

Okay, we have this big style guide, probably the only persons who ever read it entirely is their authors, and it looks a bit long, annoying, scary, or whatever. Well, despite all these rules, we have another, stronger principle: contributing with a bad style is more useful than not contributing at all. If you have great content to publish, but aren't really good at style (put "I" everywhere, have poor grammar, etc), you should still write it, and someone else will eventually correct the style.

Article titles

Pages must have appropriate titles. Names should all be capitalized properly. Try to make the article's topic the subject of the first sentence in the article. For example, write "Quake 3 is a multiplayer first-person shooter computer game released by id Software..." instead of "id Software released Quake 3, a first-person shooter...". Use boldface for the first (and only the first) appearance of the title.

Roman numerals

All numbers in game titles must be written using the decimal numeral system (for the article page name only), even if the proper game name write them using the roman numeral system. In this case, the article page name will use decimal numerals, and a redirection should be made for the version using roman numerals. For instance, see Unreal II: The Awakening and Unreal 2: The Awakening.

Sections and headings

Separating articles into sections makes them easy to read and navigate. Headings are used to split articles into sections.

Markup

Use two equal signs (==) style markup for headings. Start with ==, add the heading title, then end with ==.

This section's heading was created with the markup:

==Sections and headings==

This subsection's heading was created with the markup:

===Markup===

Wording

Text elements

Font colors

Colored font can be used sparingly, though not in very bright colors. For example, you can use a dark color for a warning. Note that light colors will not show up well against the article's white background. The only exception to this rule is when colors are needed as an illustration (for instance in a section about custom colored names).

Invisible comments

Invisible comments are used to communicate with other editors in the article body. To do so, enclose the text which you intend to be read only by editors within <!-- and -->. For example, doing <!-- Hi. --> will be hidden in the article.

Bulleted lists

Bulleted lists can be used, for instance, to list cheats. Don't forget proper punctuation.

Numbered lists

Numbered lists can be used for listing steps in a process.

Bold and italics

Place two apostrophes (''Italicized text'') on either side of a selection of text to italicize the selection. Italics are mainly used to emphasize certain words, though they should be used sparingly. Also note that game names should always be italicized. Italics may make longer phrases or sentences difficult to read.

Place three apostrophes ('''Boldfaced text''') on either side of a selection of text to boldface the selection. Bold is used as a stronger emphasis than italics, although it should be used sparingly as well. The first appearance of an article's title in the article should always be boldfaced.

Place five apostrophes ('''''Boldfaced and italicized text''''') on either side of a selection to use bold and italics in combination on the selection. Bold and italics combined emphasize selections well, but should be used extremely rarely. The only common case in which bold and italics are used together is the first occurrence of the game name which is the same as the page title.

As you can see, bold works well to emphasize sentences as well as short phrases and single words, while italics are a much weaker emphasis for sentences, but work well on short phrases or single words. Bold and italics are used in combination very rarely. Excessive use of any of these text elements will make the entire article difficult to read, so please use them in appropriate situations.

Grammar and spelling

Language

Anything written in this wiki should be in English. The only exception to this rule is user talk pages and (partially) user pages.

Punctuation

Commas, dots, semi-colons, etc, should not be preceded by a space.

Computer units

Please use the standard computer units as mentioned on http://www.patheticcockroach.com/mpam4/index.php?p=5 and as supported by the Committee for Weights and Measures (CIPM) and the Institute of Electrical and Electronics Engineers (IEEE), i.e.:

For instance, RAM is always measured in MiB/GiB, not in MB/GB. Hard drives, however, are most often measured in GB/TB by manufacturers, while being most always measured in GiB/TiB by software makers. In Windows XP, disk space is displayed as being measured in GB/TB, while it's in fact measured in GiB/TiB.

For more details, see w:Binary prefix#IEC standard prefixes.

Usage and spelling

American English spelling should be used at all times. Common examples of this include:

See also Wikipedia:American and British English spelling differences

Images

Some general guidelines which should be followed are listed below.

Uploading images

Captions

Complete sentences in captions should always end in a period. If the caption is not a complete sentence, it generally should not have a period at the end. Captions should also not be italicized.

Wikilinking

Writing articles

Everyone is encouraged to contribute meaningfully to the wiki.

Ownership and bias

Facts and trivia

If you have a piece of information or trivia that you would like to add to an article, yet are unsure of its accuracy, leave a note on the talk page of the article so that all editors can discuss it. Do not engage in edit wars on the article page.

Numbers

For numbers a comma should be used as a thousands separator.

Dates

All dates should be written using the ISO 8601 YYYY-MM-DD format (e.g. 2008-04-26) in infoboxes, or (day/month/year, e.g. 26 April 2008) in articles main text. Note that no commas are used in the International format.

See Wikipedia:Wikipedia:Manual of Style (dates and numbers) as well as Wikipedia:Calendar date.

External links

Feel free to link to other sites, like the TrueCombat:Elite home page. However, please avoid linking to too many fan sites: choose a few ones with the best content. For instance a fansite which provides most custom maps and mods for a game is interesting to add, but the website of the maker of a few maps with nothing else than these maps isn't.

Personal tools
Variants
Actions
Navigation
Community
Toolbox