Control Wiki:Manual of Style

This page is subject to change

This page is subject to changes, so information may not be the same in the near future.

The Manual of Style is the style manual for all Control Wiki articles. It describes the guidelines that should be followed when there is doubt or disagreement about which style to follow in articles. The style manual also gives useful information and advice on article formatting and templates.

Note: These guidelines were in parts or in total inspired by the Roblox Wiki; see their Manual of Style here.

Principles

This style guide has multiple purposes. One of them is to resolve conflicts among editors. Another is to suggest good style: some style guidelines are subjective preferences, but others are preferable for objective reasons, either because they are standard and commonly accepted or because they have advantages such as resolving ambiguities. The most important purpose of this style guide, though, is consistency among Control Wiki articles and inside articles; thus it is preferable for an article to use the wrong style everywhere than for it to use the right style in one place and the wrong style everywhere else. This is why whenever you write an article, you should pick one style and stick to it throughout the article, and whenever you contribute new content to an article, you should follow the style currently adopted in that article.

In case of doubt

For all of the matters not discussed on this page, you should refer to the English Wikipedia's Manual of Style or to the simplified version. This manual is too large to memorize and is meant as a reference in case of disagreement between editors or doubt about which style to follow in an article. Just like you're not expected to memorize the entire dictionary before you start writing in English, you don't have to memorize the entire manual of style to contribute to articles on this wiki.

Article structure and titles

This section describes how articles should be structured and section titles formatted.

Article structure

Articles begin with an introductory lead section, which appears above the table of contents. The lead section does not have a section heading. Hatnotes, message boxes, infoboxes, and sidebars sometimes appear before the lead section.

A table of contents is automatically inserted before the first section heading when at least three headings are used in the article. The table of contents can be placed on the right with the {{tocright}} template.

Elements of an article should almost always be ordered in this manner:

1. Editor comments (such as archive links)
2. Hatnotes
3. Article message boxes
4. Infoboxes
5. Lead section
6. Table of contents
7. Content
8. See also
9. Notes and references
10. Further reading
11. External links
12. Navboxes
13. Categories

Articles should not contain unorganized lists of miscellaneous information.

Titles

Article titles and section titles should be written in sentence case. This is sentence case; This is Not Sentence Case. The original capitalization should be kept for proper nouns, including names of locations, characters, events, items, and the name of the Manual of Style itself. Section titles should only be used to describe a section of the article, should not be at the beginning of an article, and should not contain the lead text.

Dates, numbers, currencies

This section deals with formatting of dates, numbers, and currencies. Please not that this does not apply to pages in the list of collectibles, as the pages have a direct transcript from files.

Dates and time

Dates should be formatted like October 3, 2016 or 3 October 2016, not October 3rd, 2016, October 03, 2016, 2016/10/3, or any other format. The ISO 8601 format yyyy-mm-dd can be used in tables and other locations where the dates need to be short: 2016-10-03. In templates, the #time parser function can be used, while mw.language:formatDate can be used in Scribunto modules.

Time should be formatted either in 12-hour clock times, like 2:30 p.m., or 24-hour clock times, like 14:30. Hours under 10 should have a leading zero in 24-hour clock times, like 02:30, but not in 12-hour clock times (02:30 p.m.).

Numbers

Numbers should be formatted with a comma as the thousands separator for digit grouping and a period as the decimal separator. In templates, the formatnum parser function can be used for this purpose, while mw.language:formatNum can be used in Scribunto modules.

Numbers smaller than ten should usually be written as words instead of digits in article text. That is, you should usually write one, two, three, ..., eight, nine instead of 1, 2, 3, ..., 8, 9.

Style

Since the Control Wiki is an encyclopedia, standard English should be followed in articles. American English should be preferred to other variants of English.

• Avoid comma splices. That is, independent clauses should be separated by a semicolon, a period, a colon or an em dash, but not by a comma: write Stevenson's romances are entertaining; they are full of exciting adventures. instead of Stevenson's romances are entertaining, they are full of exciting adventures.
• Profanity should not be used in articles, except where its use is appropriate in an encyclopedic context, such as in quotations.
• Avoid contractions like wasn't and it's in articles.

Tables

"A table offers an excellent means of presenting a large number of individual, similar facts so that they are easy to scan and compare."

"To produce a clear, professional-looking table, rules should be used sparingly. Many tables will require just three rules, all of them horizontal—one at the very top of the table, below the title and above the column heads; one just below the column heads; and one at the bottom of the table, along the bottom of the last row, above any notes to the table."

"You will not go far wrong if you remember two simple guidelines at all times:

1. Never, ever use vertical rules.
2. Never use double rules."

"You want to see the data, not the lines around the data."

In articles, tables should be used only for information that is tabular in nature. There are two classes available for formatting tables: the wikitable class defined by MediaWiki and the article-table class defined by Fandom. These classes are applied by adding the class attribute to the table start in the table markup. The source editor and VisualEditor insert the article-table class. Tables should generally be formatted with the article-table class.

There are two other classes made available by MediaWiki: the mw-collapsible class, which is used to make tables collapsible, and the sortable class, which is used to make tables sortable with JavaScript. Both features can be customized with other classes and attributes.

See also:

• Fandom's table best practices for tables on mobile devices
• Table dos and don'ts
• The section about tables of Wikipedia's Manual of Style

Templates

This section discusses some templates available for use in articles.

Infoboxes

Infoboxes are panels put at the top right of articles that summarize key information about the article's subject. They are created using templates. Infoboxes are used for articles about avatar shop items, groups, players, experiences, events, badges, and classes; you can find the complete list of infobox templates in Category:Infobox templates. The template pages contain documentation on using the template to add an infobox to the article.

Infobox pictures

Most infoboxes have only one picture. Infoboxes have the capability of having multiple pictures by passing the image parameter a gallery, which will display it in a fashion similar to a tabber. Pictures in infoboxes are expected to meet the following requirements:

One picture:

• Up to date (most recent).

Multiple pictures:

• Multiple experience thumbnails must...
  • still be thumbnails of the experience.
  • be in the same order as shown on the experience's page.
• Multiple user pictures must...
  • be in order from most recent picture to oldest picture.
  • display the most current picture first.
• Multiple group pictures must...
  • be in order from most recent picture to oldest picture.
  • display the most current picture first.

Infoboxes should have three or fewer images. All other images should be placed in a gallery at the bottom of the page.

Source code

The syntaxhighlight tag provided by the SyntaxHighlight extension can be used to format source code blocks with syntax highlighting. There are currently no guidelines on how the source code itself should be formatted.

Stub

The {{stub}} template is appropriate when an article has little to no information. It should be used before any infoboxes or text.