The Sims Wiki:Manual of Style/proposed

From The Sims Wiki, a collaborative database for The Sims series
This is an old revision of this page, as edited by imported>A morris at 23:37, 25 January 2011 (Adding/updating titles, lead section, grammar and spelling sections - incomplete). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.
Jump to navigation Jump to search

Template:Proposed policy

New or changed sections are higlighted. Changes are not complete.
Policies and Guidelines
General Behavior Policies
Main policies:
Alternate and Multiple Account Policy · Creation Policies · Fanon Policy · Image and file policy · Notability policy · Retirement Policy · Unreleased games policy · Voting Policy
Manual of Style
Guidelines:
Assume good faith · Be bold · Neutral point of view · Please don't bite the Newbies · Snowball clause · Simplified ruleset · 5 pillars · Spoilers
All Policies and Guidelines →

On The Sims Wiki there are a few rules of style to create a standard feel to all of our articles. The formatting described here is a guideline and can be overridden where circumstances warrant it. However, please try your best to keep to the advice outlined in this article so others may use your edits as an example when creating and editing their own articles.

These guidelines are a summary of the most important guidelines for this wiki, but a more expansive set of style guidelines can be found on Wikipedia at Wikipedia Manual of Style.

Article titles, headings, and sections

These policies govern the titles of articles and section headings on The Sims Wiki.

  • Article titles should be recognizable to readers, unambiguous, and consistent with usage in reliable English-language sources.
  • Titles should match the article contents, and should be neither too narrow nor too broad.
  • Titles should be short—preferably fewer than ten words.
  • Capitalize the first letter of the first word and any proper nouns in article and heading titles, but leave the rest in lower case (Life leading up to The Sims 2, not Life Leading Up To the Sims 2).
  • Avoid special characters such as the slash (/), plus sign (+), braces ({ }), and square brackets ([ ]); use "and" instead of an ampersand (&), unless the ampersand is an accepted part of a name
  • The final visible character of a title should not be a punctuation mark, unless the punctuation is part of a name, an abbreviation is used (Rip Co.), or a closing round bracket or quotation mark is required (Malcolm Landgraab (console)).

Article headings also adhere to the following guidelines:

  • Change a heading only after careful consideration, and if doing so use an anchor template to avoid breaking section links to it within the same article and from other articles.
  • Section and subsection headings should preferably be unique within a page; otherwise, after editing, the display can arrive at the wrong section (see also below) and the automatic edit summary can be ambiguous.
  • To avoid accessibility problems, headings should not normally contain links, especially where only part of a heading is linked.

If the topic of a section is also covered in a dedicated article, show this by inserting {{main|<Article name>}} directly under the section heading.

Article layout

Designing a template for the layout of all pages helps to keep things organized and working well so that information can be found more easily. Remember that an outline is generated based on which headings you use (Headings range from level one to six, and are represented as a section title with as many equal signs on either side as the level). The article title is level one, so you should only use level two and higher (==This is level two==).

Before editors save an article, particularly before adding a new one, the following points should be considered:

Does the article title and headers comply to naming conventions?
Does the article have a logical structure?
The article should be divided into sections and the sections into paragraphs in a way that makes sense to the reader.
Is the article user-friendly?
The article should not contain a large amount of images, at least not clumped together (Use galleries for that). Only images which are directly relevant, or the most relevant image if there are several, should be used. It is also important that the article is compatible with all the big browsers (Microsoft Internet Explorer, Mozilla Firefox, Safari).
Is the article grammatically correct?
Choice of words, spelling, punctuation...
Is the article correctly categorized?
A descriptive category makes it much easier to browse information about a certain subject.

Layout template

See also: The Sims Wiki:Project Sims/Manual of style and The Sims Wiki:Project Simology/Manual of style


Basic info about the topic. If this topic also exists outside of The Sim series, a link to Wikipedia might be in order.

==Section==
A description of this section. A section should be about a certain aspect of the
topic at hand. If there is only one main aspect, the basic info above should suffice.

===Sub-section===
More details about a certain subject of the current section. More than one sub-section may
occur.

====Sub-sub-section====
Should rarely be needed, but in some cases further division of a subject may be required.

==See also==
*[[Relevant article]]
*[[Relevant article]]
*[[Relevant article]]

==External links==
*[[wikipedia:Example|Relevant wikipedia article]]
*[http://www.example.com/ Relevant external document/site]
*[http://www.example.com/ Relevant external document/site]

Lead section

See also: Wikipedia:Manual of Style (lead section)

Unless an article is very short, it should start with an introductory lead section, before the first subheading. The lead should not be explicitly entitled == Introduction == or any equivalent header. The table of contents, if displayed, appears after the lead section and before the first subheading.

The lead should be capable of standing alone as a concise overview of the article, establishing context, and explaining why the subject is interesting or notable. It should be between one or two paragraphs long, and should be written in a clear and accessible style so that the reader is encouraged to read the rest of the article.

If possible, make the title the subject of the first sentence of the article. For example, write "Bella Goth is a character in The Sims series."

The first time the article mentions the title, put it in bold using three apostrophes — '''article title''' produces article title. Avoid other uses of bold in the first sentence, except for alternative titles of an article; for example:

The Sims: Livin' Large, also called The Sims: Livin' It Up in the United Kingdom . . .

Do not put links in the bold reiteration of the title in the article's lead sentence. For example, "Mystery [[Sim]] is a sim only seen in memories . . ." versus "Mystery Sim is a sim only seen in memories . . ."

Categories

Adding categories to an article makes it easier for the reader to find information within a specific area. Categories are added by putting [[Category:Category name]] in an article. An article may be in more than one category, but the editor should make sure not to put an article in categories just because it might be remotely related to them, but rather because it is directly related to them.

Galleries

If your article has a large amount of images that are clumped together, making a gallery is generally a good idea. The syntax for a gallery is simple:

<gallery>
Image:Wiki.png
Image:Wiki.png|Captioned
Image:Wiki.png
Image:Wiki.png|[[Wikipedia|Links]] can be put in captions.
Image:Wiki.png
Image:Wiki.png|Full [[MediaWiki]]<br />[[syntax]] may now be used…
</gallery>

Galleries should be left-aligned, including captions and width set to either 120 or the default (no defined setting)

See also

Using templates

A template in wikicode is basically an inclusion of another article. However, templates are specifically designed to be included, and may take parameters to change their content. There are many templates available to make it easier for the editor when writing an article.

Stubs

An article that is a stub is an article that is incomplete and/or too short. To tag an article as a stub, simply add {{stub}} to the bottom of it.

You can find more specific stubs in the stubs category.

Articles that are blank or contain no useful information will be deleted.

Sim Biographies

There are several templates that can be added to a Sim's page so that a lot of their biography can be displayed easily.

For information on which templates to use and how to use them see Project Sims/Manual of style.

Families

Use {{FamilyInfobox}} to add an infobox to a family article, or to give structure to the entire page use {{Family}}. {{FamilyPage}} can also be used with FamilyInfobox for the same effect as Family.

If the family appears in several games use {{Family-start}} and {{Family-end}}, with at least two of the following in between: {{Family1}}, {{Family2}}, {{Family3}}.

Player stories

Player stories should not be a part of the main article but a sub-page. Player stories sub-pages should be marked with the {{Player Stories}}, {{Family Player Stories}}, {{Pet Player Stories}} or {{Neighborhood Player Stories}} templates.

More information is available at The Sims Wiki:Player stories.

Games

Articles about game titles in The Sims series use {{Game}} to display condensed information about it.

Unreleased and newly released

If an article contains information about an unreleased or newly released product, the under development template should be used. To tag an article, add {{under development|<release type>|<game code>}}.

Tagging articles for deletion/merging

If you come across an article which does not stand on its own (It is too short and cannot be expanded, or it contains very similar information to another article) you may want to tag it for merging with another article. If merging is not possible, then tagging it for deletion might be required.

To tag an article for merging with another article, use {{merge|<Other article>|<reason>}} where Other article is the article which the current article should be merged into. To tag an article for deletion, simply add {{delete|<reason for deletion>}}.

Grammar and spelling

Since a wiki article must be as clear as possible for all the people reading it, editors must keep close to correct grammar and spelling standards to ensure clear communication.

Capitalization

Titles such as mayor or detective start with a capital letter when used as a title (followed by a name): Detective Dan D. Mann not detective Dan D. Mann. When used generically, they should be in lower case: Dan is a detective.

Traits, aspirations, life stages, life states, careers, skills, motives, talent badges, interests, etc., likewise should only be capitalized when used as a proper noun, i.e. as someone's name.

Do not use capital letters for emphasis; where wording alone cannot provide the emphasis, use italics.

Italics

Italics may be used sparingly to emphasize words in sentences (whereas boldface is normally not used for this purpose).

Italics are used for the titles of works, such as books and games. The titles of articles, chapters, and other short works are not italicized but are enclosed in double quotation marks. For example, italicize The Sims.

U.S. English and commonwealth English

Cultural clashes over grammar, spelling, and capitalisation/capitalization are a common experience on wikis. Remember that millions of people have been taught to use a different form of English from yours, including different spellings, grammatical constructions, and punctuation.

Where possible, the preferred use on The Sims Wiki is U.S. English for spellings. Where certain words might cause confusion (see American and British English differences), it is preferable to avoid the word or phrase altogether. Where possible, international standards are to be used (Dates, names, etc.) to avoid confusion.

Regardless, articles should generally follow the same style throughout. Each article should have uniform spelling and not a haphazard mix of different spellings, which can be jarring to the reader. For example, do not use center in one place and centre in another in the same article (except in quotations or for comparison purposes).

Bear in mind that some words shared by all English speakers are spelled one way by Americans (and at times Canadians and Australians) but are spelt differently in most other English speaking countries; it is generally acceptable to leave an article alone where the style is consistent throughout the article - though changes to important articles to adapt them to house style are occasionally useful, please don't make a point of changing an article to your preferred style.

Related articles