The Sims Wiki:Manual of Style/proposed
- New or changed sections are higlighted. Changes are not complete.
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 (Ridiculous D.O.G.), 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==).
Layout template
- See also: The Sims Wiki:Project Sims/Manual of style and The Sims Wiki:Project Simology/Manual of style
{{distinguish|similar article}}
{{distinguish|similar article}}
{{article management template}}
{{article management template}}
{{Infobox}}
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.
==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.
==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.
== Gallery ==
Gallery of images relevant to the topic.
==See also==
*[[Relevant article]]
*[[Relevant article]]
*[[Relevant article]]
== References ==
<references/> or {{Reflist}}.
==External links==
*[[wikipedia:Example|Relevant wikipedia article]]
*[http://www.example.com/ Relevant external document/site]
*[http://www.example.com/ Relevant external document/site]
{{navigation template}}
{{navigation template}}
[[Category:Relevant category]]
[[Category:Relevant category]]
[[Category:Relevant category]]
[[Interwiki:links]]
[[Interwiki:links]]
[[Interwiki:links]]
Non-article content
Non-article content (such as disambiguations and article message boxes) should be located above the lead.
See The Sims Wiki:Templates#Article management templates and The Sims Wiki:Templates#General wiki templates.
Infoboxes
Infoboxes, boxes which summarise data relating to the article, should appear at the top-right corner of the article content.
Table of contents
A table of contents (TOC) will automatically appear in articles with a minimum of four headings (unless forced by the below options). By default this will be left-aligned above the first section heading.
- To force a TOC position (left-aligned): __TOC__
- To completely remove the TOC from a page: __NOTOC__
The table of contents can be right-aligned—but this should only be done if it is very long (over 15 entries) and an information box is not occupying the top-right corner of the article.
- Right-aligned TOC that floats next to text: {{tocright}}
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 . . ."Images
To write.
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
Tables
To write.
Links
To write.
- See also: Wikipedia:Navigation templates
Use navigation tables or templates to link to multiple related articles.
- They should include only those articles that would help the reader in reading up on related topics.
- They should be kept small in size as a large template has limited navigation value.
- They should not be too small. A navigation template with fewer than a handful of links can easily be replaced by "See also" sections.
- Navigation templates provide navigation between existing articles. Avoid including red links or unlinked information.
- Avoid linking to redirects or disambiguation pages.
Navigation tables or templates should be page-width (horizontal) and use {{Navbox}}. These navboxes should be placed at the end of a page, just above the categories (and below any succession boxes). The navboxes should be ordered by the best related concepts.
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.
Writing
When you're editing wikis, you're both academic and artist. You have to be accurate, but you also have to be interesting. Neither one can dominate; you have to skillfully balance both.
- Keep your writing concise. Don't use two words where one will do. Keeping your writing simple will make it easy to understand and easy to expand on. Use complete sentences whenever possible. When you write, use grammar as a toolbox: know the rules, but only break them on purpose.
- Check your spelling and grammar. Do not use 'u' in place of 'you' or '2' in place of 'to'. Write the way you would for a class paper or a newspaper article.
- Keep all of the topics you cover within the scope of the article. What that means is, you don't need to give a detailed explanation alien abduction on the page about pregnancy. Consider the article's title as your point of origin and write from that perspective. Make use of the wiki's ability to link to more detailed articles or external sources for more information.
- Write from an impersonal perspective.' Do not use "I". For example, do not write, "The Grim Reaper will appear in The Sims Medieval, as far as I know." Avoid drawing attention to the author (yourself) as much as possible.
- Use of the second person "you", which is often ambiguous and contrary to the tone of an encyclopedia, is discouraged. Instead, refer to the subject of the sentence or use the passive voice, for example do not write "The game creates an invisible barrier which prevents you from entering the building. To correct this, you must go into build mode ..." Instead write "The game creates an invisible barrier which prevents sims from entering the building. To correct this, the player must go into build mode ..."
- Be bold. If you know something is wrong, correct it. If you think you could word something better, write it. If an article has a glaring deficiency, fill it. Even if your first attempt isn't golden, you can fix it later or someone else will come along and fix it for you. Don't be afraid to screw up.
Writing about fiction
The Sims Wiki articles should describe fiction and fictional elements from the perspective of the real world, not from the perspective of the fiction itself.
An in-universe perspective describes the narrative from the perspective of characters within the fictional universe, treating it as if it were real and ignoring real-world context and sourced analysis. An in-universe perspective is inaccurate and misleading, inviting unverifiable original research. Most importantly, in-universe perspective defies community consensus as to what we do not want The Sims Wiki to be or become.[citation needed]
When writing about fiction, keep the following in mind:
- Write from a real-world perspective;
- Maintain a balanced use of both primary and secondary sources;
- Avoid original research;
- Reference all information and cite your sources;
- Give weight where weight is due;
- Put all information into context with the original fiction;
- Check with the image use policy before adding images to any article;
- Avoid creating lists of trivia; instead, incorporate relevant information into the body of the article;
- The amount of copyrighted work used should be as little as possible.
Time references
Avoid statements that date quickly, except on pages that are regularly updated, like current events pages. Avoid words such as now and soon (unless their intended meaning is clear), currently and recently (except on rare occasions where they are not redundant), or phrases such as in modern times and the sixties. Instead, when writing about past events use more precise phrases such as during the 1990s or in August 1969. For future and current events, use phrases such as as of June 2024 or since the beginning of 2010 that indicate the time-dependence of the information to the reader.
To help editors keep information up to date, statements about current and future events may be used with the as of technique. This is done by using the {{as of}} template to tag information that may become dated quickly: {{as of|<2024>}} produces the text As of 2024[update] and categorizes the article appropriately. This technique is not an alternative to using precise language. For instance, one should not replace since the start of 2005 with {{as of|<2005>}} because some information (the start of 2005) would be lost; instead, use either the plain text or a more advanced feature of {{as of}} such as {{as of|2005|alt=since the start of 2005}}.
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.
When using "The" mid-sentence, generally do not capitalize the definite article. However, some exceptions, including most titles of artistic works, should be quoted exactly according to common usage.
- Incorrect (generic): <example>
- Correct (generic): <example>
- Incorrect (title): Bella Goth appeared in the Sims.
- Correct (title): Bella Goth appeared in The Sims.
- Correct (title): Bella Goth's image is on the Bella Squared wall hanging.
- Incorrect (exception): A community lot in The Urbz: Sims in the City is the Foundry.
- Correct (exception): A community lot in The Urbz: Sims in the City is The Foundry.
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.
Tense
Most articles should be described as facts, so use the present or future tenses. "The Gypsy matchmaker is in The Sims 2: Nightlife." "This skill can be learned by swimming." Works of fiction are generally considered to "come alive" when experienced. They exist in a kind of perpetual present tense, regardless of when the fictional action is supposed to take place relative to "now." Thus, generally you should write about fiction using the present tense, not the past tense.
The major exception to this rule are undocumented patch notes. The tense used should match how Electronic Arts's official patch notes are written. For the most part, past tense should be used, "Fixed an issue where ghosts could become stuck in vehicles." For new features, future tense can be used as well, primarily used in conjunction with now, "A Bay Window will now appear in the game," "Players may now use the Tattoo feature to customize Sims when in Create a Sim." Other tenses should be converted. For example, "Story progression will be improved" should be "Story progression has been improved."
Punctuation
- See also: Wikipedia:Manual of Style#Punctuation
Where footnotes (ref tags) are adjacent to most punctuation, such as a comma or period, place them after the punctuation, with no intervening space.
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.