RTGame:Style guide: Difference between revisions

Manual of styles on the RTGame Wiki
RTGame>Alistair3149
(→‎Layout: seo template update)
 
No edit summary
Tag: 2017 source edit
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Note|'''Note:''' Most guidelines in this style guide are established three years after the creation of the wiki, many pages might not conform to this style guide. Please make corrections on the pages if that's the case. If you have any questions or suggestions, feel free to post on the [[{{TALKPAGENAME}}|discussion page]].}}
{{Note|'''Note:''' Most of these guidelines are new, and might not be fully established. Existing pages will not conform to these are can be edited to fit. If you have any questions or suggestions, feel free to ask in the [{{Discord}} Discord Server].}}
{{Shortcut|SC:SG|SC:STYLE|SC:MOS}}
{{Shortcut|RT:SG|RT:STYLE|RT:MOS}}


This '''style guide''' is made to make the Star Citizen Wiki easy to read by having the same standard across pages. The following guide is intended as a reference for general situations. It may not cover every situation that may come up.  
This '''style guide''' is made to make the RTGame Wiki easy to read by having the same standard across pages. The following guide is intended as a reference for general situations. It may not cover every situation that may come up.  


For a more complete manual of style, the Wikipedia [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Manual of Style] may be useful.   
For a more complete manual of style, the Wikipedia [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Manual of Style] may be useful.   


== Article titles ==
== Article titles ==
{{Note|'''TL;DR''': Use in-game name and sentence case for the title.}}
{{Shortcut|RT:TITLE}}
{{Shortcut|SC:TITLE}}
A title should always be exactly the same as the name of the subject, except when multiple subjects have the same name (and thus disambiguation parentheses are required).
A title should always be exactly the same as the in-game name of the subject, except when multiple subjects have the same name (and thus disambiguation parentheses are required). In cases where other CIG sources are inconsistent with in-game names, in-game names and [https://en.wikipedia.org/wiki/Sentence_case sentence case] should be used, with redirects utilized for other names.
* If there are multiple locations with one name, denote the differences with parenthesis.
* Use the same [[Star Citizen:Style guide#Capital letters|capitalization]] as the content text by [[CIG]]. Capitalize the initial letter (except in rare cases, such as [[microTech]]), but otherwise follow sentence case ([[Quantum drive]]), not title case (Quantum Drive).
** If this is for the Minecraft server, only use the first version number of the server.
* Do not use titles (in-game and out of the game) as reference for capitalization. They are often written in [https://en.wikipedia.org/Title_case title case]. Refer to the in-game description, [[Galactapedia]], and other content text instead.
** For example: Sai City (1.14), Sai City (1.16).
* Block capitals should not be used in titles (Article titles, not ARTICLE TITLES).
* Block capitals should not be used in titles (Article titles, not ARTICLE TITLES).
* Use italics if needed, conforming to [[Star Citizen:Style guide#Italics]].
* Use italics if needed, conforming to [[RTGame:Style guide#Italics]].
* Do not use articles (a, an, or the) as the first word ([[United Empire of Earth]], not The United Empire of Earth), unless it is an integral part of a name ([[The Coil]]).
* Do not use articles (a, an, or the) as the first word, unless it is an integral part of a name.
* Use full name instead of [[Star Citizen:Style guide#Abbreviations|abbreviations]] if possible ([[Roberts Space Industries]], not RSI). Use a redirect if the abbreviation is common.
* Use full name instead of [[RTGame:Style guide#Abbreviations|abbreviations]] if possible. Use a redirect if the abbreviation is common.
* Families should be titled "<surname> family" ([[Hurston family]]). This does not apply to in-game families with alternative titles ([[House Chii]]).
* Use straight quotation marks or apostrophes, create a redirect for curly ones if needed (Use ' and not ).
* Use straight quotation marks or apostrophes, create a redirect for curly ones if needed ([[Xi'an]], not [[Xi’an]]).


Sometimes [https://www.mediawiki.org/wiki/Manual:Page_title technical restrictions of MediaWiki] prevent editors naming pages after their in-game names:
Sometimes [https://www.mediawiki.org/wiki/Manual:Page_title technical restrictions of MediaWiki] prevent editors naming pages as they desire:
* The subject name does not begin with a capital letter.
* The subject name does not begin with a capital letter.
* The subject name includes a <code>/</code>.
* The subject name includes a <code>/</code>.
Line 25: Line 24:
* The subject begins with a string that would put the page in the wrong namespace. Such strings might include: <code>Project:</code>, <code>File:</code>, or <code>User:</code>, etc.
* The subject begins with a string that would put the page in the wrong namespace. Such strings might include: <code>Project:</code>, <code>File:</code>, or <code>User:</code>, etc.


In such cases, problem characters should be replaced substitutes of left out altogether. Generally, replace <code>|</code> with <code>-</code>, and <code>:</code> in namespaces with <code>-</code>; leave out "#"". False subpages should be at the same name. In all cases [https://www.mediawiki.org/wiki/Help:Magic_words#DISPLAYTITLE DISPLAYTITLE] (<code><nowiki>{{DISPLAYTITLE:microTech}}</nowiki></code> for MicroTech) should be used to mark the page as such.
In such cases, problem characters should be replaced substitutes of left out altogether. Generally, replace <code>|</code> with <code>-</code>, and <code>:</code> in namespaces with <code>-</code>; leave out "#"".


== Layout ==
== Layout ==
{{Shortcut|SC:LAYOUT}}
{{Shortcut|RT:LAYOUT}}
A simple article should have at least a lead section, references, [[Star Citizen:Short description|short description]], and a [[Template:SEO|SEO template]]. The rest can be added when needed. For more details on template placement, see [[Star Citizen:Templates]].
A simple article should have at least a lead section, references, [[RTGame:Short description|short description]], and a [[Template:SEO|SEO template]]. The rest can be added when needed. For more details on template placement, see [[RTGame:Templates]].


# Before the lead section
# Before the lead section
Line 53: Line 52:
== Sections and headings ==
== Sections and headings ==
{{Note|'''TL;DR''': Keep headings short, concise, in plain text, and in sentence case.}}
{{Note|'''TL;DR''': Keep headings short, concise, in plain text, and in sentence case.}}
{{Shortcut|SC:HEAD|SC:SECTIONS}}
{{Shortcut|RT:HEAD|RT:SECTIONS}}
Separating articles into sections makes them easy to read and navigate. Headings are used to splitting articles into sections.
Separating articles into sections makes them easy to read and navigate. Headings are used to splitting articles into sections.


Line 68: Line 67:
* Not be numbered or lettered as an outline.
* Not be numbered or lettered as an outline.
* Not be phrased as a question.
* Not be phrased as a question.
* Avoid the use of color or unusual fonts that might cause accessibility problems.
* Avoid the use of colour or unusual fonts that might cause accessibility problems.
* Not wrap headings in markup, which may break their display and also cause additional accessibility issues.
* Not wrap headings in markup, which may break their display and also cause additional accessibility issues.


Line 79: Line 78:


=== Lead sections ===
=== Lead sections ===
{{Shortcut|SC:LEAD}}
{{Shortcut|RT:LEAD}}
A lead (introduction) summarizes the most essential points of an article, creating interest in the topic.
A lead (introduction) summarizes the most essential points of an article, creating interest in the topic.
* Subject should be defined within the first 250 characters.
* Subject should be defined within the first 250 characters.
Line 88: Line 87:
== Text elements ==
== Text elements ==
=== Internal links ===
=== Internal links ===
{{Shortcut|SC:WIKILINK}}
{{Shortcut|RT:WIKILINK}}
* Don't link the same article more than once, except if the article is too long or the link is in a [[Star Citizen:Templates|template]]. For example, [[Aegis Dynamics]] may be mentioned five times. You only have to link to Aegis Dynamics once.
* Don't link the same article more than once, except if the article is too long or the link is in a [[RTGame:Templates|template]]. For example, [[I Want Die]] may be mentioned five times. You only have to link to I Want die once.
* Piped link formats for simple plurals (<code>s</code>, <code>es</code>) are generally unnecessary. For example, use <code><nowiki>[[quantum drive]]</nowiki>s</code> instead of <code><nowiki>[[quantum drive|quantum drives]]</nowiki></code>.
* Piped link formats for simple plurals (<code>s</code>, <code>es</code>) are generally unnecessary. For example, use <code><nowiki>[[quantum drive]]</nowiki>s</code> instead of <code><nowiki>[[quantum drive|quantum drives]]</nowiki></code>.
* On the other hand, use pipe symbols for complex plurals. For example, <code><nowiki>[[wolf|wolves]]</nowiki></code> instead of <code><nowiki>[[wolf]]</nowiki>s</code>.
* On the other hand, use pipe symbols for complex plurals. For example, <code><nowiki>[[wolf|wolves]]</nowiki></code> instead of <code><nowiki>[[wolf]]</nowiki>s</code>.
* Do not place the last letters of a plural outside of a link that already has alternate text. For example, <code><nowiki>[[F7A Hornet Mk II|Hornets]]</nowiki></code> should be used instead of <code><nowiki>[[F7A Hornet Mk II|Hornet]]</nowiki>s</code>.
* On article with translations, use <code><nowiki>[[Special:MyLanguage/PAGE|PAGE NAME]]</nowiki></code> to link visitor to the appropriate language automatically. That should be avoided in pages not in translation as it disables the article preview feature.


=== External links ===
=== External links ===
Avoid linking to external sites in the main article with the rare exception of the RSI site, though it should be linked through the {{tl|Link RSI}} template. External links can be added to other sections such as trivia, notes, see also, references if it adds value to the article.
External links should be kept to official RTGame sources where possible.
Some examples of which include:
* RTGame Twitch
* Twitch Clips
* RTGame Stream Archive Channel
* RTGame Youtube
* RTGame Twitter


=== Font colors ===
These are best used as references and should be sourced where possible.
Colored font should be avoided except for templates. If you need to use a colored font, you might want to create a template instead.
 
=== Font colours ===
Coloured font should be avoided except for templates. If you need to use a coloured font, you might want to create a template instead.


=== Bold ===
=== Bold ===
{{Note|'''TL;DR''': Bold the first mention of the subject and its alias.}}
{{Note|'''TL;DR''': Bold the first mention of the subject and its alias.}}
{{Shortcut|SC:BOLD}}
{{Shortcut|RT:BOLD}}
Boldface is commonly used on the wiki, but restricted to several usages:
Boldface is commonly used on the wiki, but restricted to several usages:
* First mention of the subject of the page. For example, the term Gladius is bolded on the [[Gladius]] page.
* First mention of the subject of the page. For example, the term I Want Die is bolded on the [[I Want Die]] page.
* First mention of the alias of the subject of the page. For example, the term RSI is bolded on the [[Roberts Space Industries]] page.
* First mention of the alias of the subject of the page. For example, the term RSI is bolded on the ''Roberts Space Industries'' page.
* Pseudo-heading, when a heading does not form a section and use as a stylistic heading.
* Pseudo-heading, when a heading does not form a section and use as a stylistic heading.
* Avoid using bold for emphasis in the article text, instead use {{tl|em}}.
* Avoid using bold for emphasis in the article text, instead use {{tl|em}}.
Line 118: Line 123:
=== Italics ===
=== Italics ===
{{Note|'''TL;DR''': Use <nowiki>{{em}}</nowiki> to emphasize text. Some names and titles should be italicized.}}  
{{Note|'''TL;DR''': Use <nowiki>{{em}}</nowiki> to emphasize text. Some names and titles should be italicized.}}  
{{Shortcut|SC:ITALICS}}
{{Shortcut|RT:ITALICS}}
Italics should be used in the following conditions:
Italics should be used in the following conditions:
* Emphasize text, but {{em|only}} through the {{tl|em}} template or the <code><nowiki><em>...</em></nowiki></code> HTML tag.
* Emphasize text, but {{em|only}} through the {{tl|em}} template or the <code><nowiki><em>...</em></nowiki></code> HTML tag.
* Certain names and titles both in real world and in-lore. Common examples on the wiki are mentioned below. For an exhaustive list, see [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Titles#Italics Wikipedia:Manual of Style for titles].
* Certain names and titles. For an exhaustive list, see [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Titles#Italics Wikipedia:Manual of Style for titles].
** Named ships (''[[Belligerent Duck]]'', [[UEES Chimera|UEES ''Chimera'' (CVE-35)]])
** Ship class named after a named ship (the ''Bengal''-class carrier)
** Video games (''[[Star Citizen]]'', ''[[Arena Commander]]'').
*** Note that the term Squadron 42 could refer to both the game ''[[Squadron 42]]'' and the in-lore squadron [[42nd Squadron|Squadron 42]].
** Books (''[[A Gift for Baba]]'', ''[[Cassandra's Tears]]'')
** Magazines (''[[Jump Point (magazine)|Jump Point]]'')
** Shows (''[[Inside Star Citizen]]'', ''[[Whitley's Guide]]'')
 
=== Quotes ===
* Use straight quotation marks <code>' "</code> instead of curly quotation marks.
* Use {{tl|Quote}} for quotes more than 40 words or more than one paragraph.
* Quoted sources should leave date formats in whatever the quoted source used. (So don't edit a quote to change the date format.)


=== Numbers ===
=== Numbers ===
Line 141: Line 134:


=== Date and time ===
=== Date and time ===
* Use YYYY-MM-DD HH:MM:DD format, aka [https://en.wikipedia.org/wiki/ISO_8601 ISO 8601]. Drop any unneeded precision on the right.
* Use DD-MM-YYYY format. Drop any unneeded precision on the right.
* In-lore dates are usually done in [[Standard Earth Time]] (SET), "today" tracking with real life date + 930 years.
* When approximating dates, use the same YYYY(+ whatever precision available) format and add (before), (after) or (circa) as a suffix to the date.(2946 (before); 2923-12-01 (after); 2700 (circa))
* Date ranges indicating a status is current should include "Present", or leave blank. Ex Start:2942 End: Present
* Date ranges indicating a status is current should include "Present", or leave blank. Ex Start:2942 End: Present
* {{tl|Start date and age}} can be used to indicate the passage of time both in real world and in lore ({{Start date and age|2018|02|12}}; {{Start date and age|2912|sctime=yes}}).
* {{tl|Start date and age}} can be used to indicate the passage of time ({{Start date and age|2018|02|12}}).


== Grammar and spelling ==
== Grammar and spelling ==
{{Shortcut|RT:RT|RT:RTGame}}
=== Referring to RTGame ===
RTGame's brand is primarily <code>RTGame</code> and he should be addressed as such.
When referring to him multiple times in one article, this can be shorted to RT, but only if <code>RTGame</code> has already been mentioned.
When the name differs, for example when referring to RT's Social Media accounts, you can instead use the relevant username such as <code>RTGameCrowd</code>.
* The capitalisation must always stay the same.
** RT is always to be capitalised.
** The G and C in ''Game'' and ''Crowd'' respectively, should also be capitalised.
RT's real name (Daniel) should only be used in articles where this is relevant, such as talking about Daniel as a person. When using their real name, please write the name in full and avoid using any shortened variants of the name (Dan, etc).


=== Capital letters ===
=== Capital letters ===
{{Note|'''TL;DR''': Use common sense and lower case for everything unless it is a proper noun confirmed by CIG.}}
{{Note|'''TL;DR''': Use common sense and lower case for everything unless it is a proper noun.}}
{{Shortcut|SC:CAPS}}
{{Shortcut|RT:CAPS}}
Avoid unnecessary capitalization. It is primarily needed for proper names, acronyms, and for the first letter of a sentence. Refer to CIG sources on what words should be capitalized, and use common sense to determine if it is a proper noun. Note that title text should always be ignored as they are often written in title case. The capitalization in [[Galactapedia]] should be used if there are any conflicts.
Avoid unnecessary capitalization. It is primarily needed for proper names, acronyms, and for the first letter of a sentence. Note that title text should always be ignored as they are often written in title case.


Below are a list of common nouns that should always be capitalized:
Below are a list of common nouns that should always be capitalized:
* People names ([[Chris Roberts]])
* People names
* Vehicle ([[Avenger Stalker]])
* Character names
* Vehicle names ([[UEES Retribution|UEES ''Retribution'']])
* Game names
* Company and faction names ([[Crusader Industries]])
* System names ([[Leir]])
** Note that the word "system" should be in lower case ([[Stanton|Stanton system]])
* Planet names ([[Earth]])
* Named military groups ([[87th Battle Group]])
** Note that capitalization only applies when it is a specified group (battle group not Battle Group)


Note that rare exception does occur with cases like the planet and company ([[microTech (planet)|microTech]]), and its product ([[mobiGlas]]).
Note that rare exception does occur, and can be discussed in the Discord if needed.


=== Spelling ===
=== Spelling ===
[https://en.wikipedia.org/wiki/American_English American English] should be used at all times. Everything in ''Star Citizen'' uses the American spelling, so do the wiki. If there is a spelling conflict between CIG and American English, use CIG spelling.
British English should be used at all times. RTGame uses British, and so does the wiki.


=== Abbreviations ===
=== Abbreviations ===
{{Note|'''TL;DR''': Try not to use abbreviations.}}  
{{Note|'''TL;DR''': Try not to use abbreviations.}}  
{{Shortcut|SC:ABBR}}
{{Shortcut|RT:ABBR}}


Abbreviations should only be used if it is defined in the article, and it does not affect the readability. Additional rules apply for article title as stated below:
Abbreviations should only be used if it is defined in the article, and it does not affect the readability. Additional rules apply for article title as stated below:
* Do not use abbreviations for article title unless there is no known full name.
* Do not use abbreviations for article title unless there is no known full name.
* [[Star Citizen:Redirect|Redirect]] acronyms and abbreviations to the article. The redirect page itself should be placed into [[:Category:Abbreviations]].
* [[RTGame:Redirect|Redirect]] acronyms and abbreviations to the article. The redirect page itself should be placed into [[:Category:Abbreviations]].
* Create [[Star Citizen:Style guide#Disambiguation|Disambiguation]] page if two or more different meanings for the abbreviations exist, instead of a redirect page.
* Create [[RTGame:Style guide#Disambiguation|Disambiguation]] page if two or more different meanings for the abbreviations exist, instead of a redirect page.


=== Point of view ===
=== Point of view ===
{{Shortcut|SC:POV}}
{{Shortcut|RT:POV}}


* Third-person wherever possible
* Third-person wherever possible
Line 186: Line 183:
* Avoid personal ideas and opinions
* Avoid personal ideas and opinions


For example: "The [[Avenger Stalker]]'s primary function is bounty hunting with its loadout of EMP Suckerpunch cannons." not "I think The [[Avenger Stalker]] is the best ship in the game". Writing in this neutral tone will take practice, but it provides the readers with the most information and the least confusion.  
For example: "I Want Die is one of RTGames original Miis." not "I think I Want Die is the best Mii". Writing in this neutral tone will take practice, but it provides the readers with the most information and the least confusion.


== Editorial notes ==
== Editorial notes ==
Please use the {{tl|Note}} when it's necessary to make editorial comments. Like when adding Errata update to [[Comm-Link]]s for example.  
Please use the {{tl|Note}} when it's necessary to make editorial comments.  


Example (from [[Comm-Link:Galactic_Guide_-_Davien|Galactic Guide: Davien]]):
Example:
{{Note|'''Wiki Staff Editorial Note:''' As of 2016-10-11 there is no known jump point between Davien and Croshaw in the {{Link RSI|url=starmap?location=DAVIEN|text=Ark Starmap}}}}
{{Note|'''Wiki Staff Editorial Note:''' As of 15-03-2021 RTGameCrowd on Twitch is now known as RTGame}}


== Citations & references ==
== Citations & references ==
First of all: please do cite references.
First of all: please do cite references.


References should link back to official [[Cloud Imperium Games]] sources. Preferably using the {{tl|Cite RSI}} and {{tl|Cite Jump Point}}. Please don't link directly to the PDF of [[Jump Point (magazine)|Jump Point magazine]], as they are subscriber-only content, cite them using the template instead.
References should link back to official RTGame sources.
 
Some examples of which include:
For official [[:Category:Comm-Link|Comm-Links]], we should also be using the "int=" parameter for internal links, which will allow the citations to link to both the internal and external versions of the comm-links.
* RTGame Twitch
 
* Twitch Clips
ATV and RTV should be named like this:
* RTGame Stream Archive Channel
* ''Around The Verse'' 1.30
* RTGame Youtube
* ''Reverse The Verse'' 2.30
* RTGame Twitter
 
For the most part, this is for references only. We don't have permission to reproduce the contents, so paraphrase or use explicit (short) quotes, following normal fair use of copyrighted material.


== Non-article styles ==
== Non-article styles ==
Line 211: Line 206:
Wikis must resolve ambiguous references when a link is to a term that has more than one distinct meaning. This process is called [[Wikipedia:Disambiguation|disambiguation]].
Wikis must resolve ambiguous references when a link is to a term that has more than one distinct meaning. This process is called [[Wikipedia:Disambiguation|disambiguation]].


When one term is clearly the more expected result, it can remain the primary link, and a {{tl|for}} or {{tl|about}} entry should head off the article. (See [[Star Citizen:Templates]] for examples.)
When one term is clearly the more expected result, it can remain the primary link, and a {{tl|for}} or {{tl|about}} entry should head off the article. (See [[RTGame:Templates]] for examples.)


When it is not so clear, the term becomes a disambiguation page, linking to the possible meanings.
When it is not so clear, the term becomes a disambiguation page, linking to the possible meanings.
Line 217: Line 212:
Alternate meanings take the form of <code>Term (other meaning)</code>. (Note lower case for disambiguation meaning.) Alternative meanings should also have a for statement at the head of the article.
Alternate meanings take the form of <code>Term (other meaning)</code>. (Note lower case for disambiguation meaning.) Alternative meanings should also have a for statement at the head of the article.


Example: [[Orion]] (ship), [[Orion (system)]]
=== Comm-Link ===
Lore on the Star Citizen Wiki is largely written by [[CIG]] with the intention of "filling-out" the universe with characters, stories, and locations. These lore posts are documented as part of the [[Star_Citizen:Comm-Link_Archive| Comm-Link Archive Project]].
The writing style of these posts is vastly different from that of the other neutral posts you may find on the wiki. They include first-person accounts, human interest stories, and news bulletins. As a result, many lore posts use slang, unfriendly language, and strong opinions. These should not be taken as guidelines for the writing style on other Star Citizen Wiki content.
The lore posts are taken "as-is" from CIG's website and other CIG-official sources. As such, they should not be modified to suit the Star Citizen Wiki's tone and style. Any such pages will be documented and logged on the SCW for reference with minor edits for formatting.


=== Talk and user pages===
=== Talk and user pages===
Line 232: Line 219:


== See also ==
== See also ==
* [[Star Citizen:Templates]]
* [[RTGame:Templates]]
* [[Star Citizen:Short description]]
* [[RTGame:Short description]]
* [[Star Citizen:Redirect]]
* [[RTGame:Redirect]]
 


{{credit_SC}}


{{Wiki navplate}}
{{Wiki navplate}}
{{Short description|Manual of styles on the Star Citizen Wiki}}
{{Short description|Manual of styles on the RTGame Wiki}}
[[Category:Help|Style]]
[[Category:Help|Style]]
[[Category:Policies]]
[[Category:Policies]]

Latest revision as of 14:29, 7 May 2021

Note: Most of these guidelines are new, and might not be fully established. Existing pages will not conform to these are can be edited to fit. If you have any questions or suggestions, feel free to ask in the Discord Server.

This style guide is made to make the RTGame Wiki easy to read by having the same standard across pages. The following guide is intended as a reference for general situations. It may not cover every situation that may come up.

For a more complete manual of style, the Wikipedia Manual of Style may be useful.

Article titles

A title should always be exactly the same as the name of the subject, except when multiple subjects have the same name (and thus disambiguation parentheses are required).

  • If there are multiple locations with one name, denote the differences with parenthesis.
    • If this is for the Minecraft server, only use the first version number of the server.
    • For example: Sai City (1.14), Sai City (1.16).
  • Block capitals should not be used in titles (Article titles, not ARTICLE TITLES).
  • Use italics if needed, conforming to RTGame:Style guide#Italics.
  • Do not use articles (a, an, or the) as the first word, unless it is an integral part of a name.
  • Use full name instead of abbreviations if possible. Use a redirect if the abbreviation is common.
  • Use straight quotation marks or apostrophes, create a redirect for curly ones if needed (Use ' and not ’).

Sometimes technical restrictions of MediaWiki prevent editors naming pages as they desire:

  • The subject name does not begin with a capital letter.
  • The subject name includes a /.
  • The subject name includes a character that cannot be used in page names, including # < > [ ] | { } _.
  • The subject begins with a string that would put the page in the wrong namespace. Such strings might include: Project:, File:, or User:, etc.

In such cases, problem characters should be replaced substitutes of left out altogether. Generally, replace | with -, and : in namespaces with -; leave out "#"".

Layout

A simple article should have at least a lead section, references, short description, and a SEO template. The rest can be added when needed. For more details on template placement, see RTGame:Templates.

  1. Before the lead section
    1. Related articles templates
    2. Maintenance templates
    3. Infoboxes
    4. Images (if no infoboxes)
  2. Body
    1. Lead section (also called the introduction)
    2. Content
    3. Trivia
    4. Gallery
    5. See also
    6. Notes
    7. References
  3. Bottom matter
    1. Navplates
    2. SEO template
    3. Short description
    4. Categories
    5. Stub templates

Sections and headings

TL;DR: Keep headings short, concise, in plain text, and in sentence case.

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

Markup

  • Use equals signs around a section heading: ==Title== for a primary section, ===Title=== for a subsection, and so on to ======Title======, with no level skipped.
  • =Title= is never used.
  • Spaces around the title are optional and ignored, e.g. == Title ==.

Wording

  • Keep heading short
  • Use sentence case (capitalize only the first letter of the first word and the first letter of any proper nouns).
  • Not redundantly refer back to the subject of the article (e.g., Early life, not Smith's early life or His early life).
  • Not refer to a higher-level heading, unless doing so is shorter or clearer.
  • Not be numbered or lettered as an outline.
  • Not be phrased as a question.
  • Avoid the use of colour or unusual fonts that might cause accessibility problems.
  • Not wrap headings in markup, which may break their display and also cause additional accessibility issues.

To avoid technical complications:

  • Be unique within a page, so that section links lead to the right place.
  • Avoid links, especially where only part of a heading is linked.
  • Avoid images or icons.
  • Avoid templates.
  • Avoid citations or footnotes.

Lead sections

A lead (introduction) summarizes the most essential points of an article, creating interest in the topic.

  • Subject should be defined within the first 250 characters.
  • Should be limited to a few paragraphs.
  • Subject should be mentioned as early as possible in the first sentence and should be bolded.
  • Certain information, such as strategies and trivia, should be in a separate section instead of in the lead.

Text elements

Internal links

  • Don't link the same article more than once, except if the article is too long or the link is in a template. For example, I Want Die may be mentioned five times. You only have to link to I Want die once.
  • Piped link formats for simple plurals (s, es) are generally unnecessary. For example, use [[quantum drive]]s instead of [[quantum drive|quantum drives]].
  • On the other hand, use pipe symbols for complex plurals. For example, [[wolf|wolves]] instead of [[wolf]]s.

External links

External links should be kept to official RTGame sources where possible. Some examples of which include:

  • RTGame Twitch
  • Twitch Clips
  • RTGame Stream Archive Channel
  • RTGame Youtube
  • RTGame Twitter

These are best used as references and should be sourced where possible.

Font colours

Coloured font should be avoided except for templates. If you need to use a coloured font, you might want to create a template instead.

Bold

TL;DR: Bold the first mention of the subject and its alias.

Boldface is commonly used on the wiki, but restricted to several usages:

  • First mention of the subject of the page. For example, the term I Want Die is bolded on the I Want Die page.
  • First mention of the alias of the subject of the page. For example, the term RSI is bolded on the Roberts Space Industries page.
  • Pseudo-heading, when a heading does not form a section and use as a stylistic heading.
  • Avoid using bold for emphasis in the article text, instead use {{em}}.

Boldface is sometimes applied automatically, either by MediaWiki software or by the browser:

  • Section headings
  • Description lists
  • Table headers and captions (but not image captions)
  • A link to the page on which that link appears called a self link

Italics

TL;DR: Use {{em}} to emphasize text. Some names and titles should be italicized.

Italics should be used in the following conditions:

Numbers

  • Use comma as the thousands separator. Separators should be used for numbers greater than 1,000.
    • Do not use separators for template input, the template will format the number.
  • Ranges should be indicated with an endash (; ) rather than a hyphen ("1–5" not "1-5").

Date and time

  • Use DD-MM-YYYY format. Drop any unneeded precision on the right.
  • Date ranges indicating a status is current should include "Present", or leave blank. Ex Start:2942 End: Present
  • {{Start date and age}} can be used to indicate the passage of time (February 12, 2018; 6 years ago (2018-02-12)).

Grammar and spelling

Referring to RTGame

RTGame's brand is primarily RTGame and he should be addressed as such. When referring to him multiple times in one article, this can be shorted to RT, but only if RTGame has already been mentioned. When the name differs, for example when referring to RT's Social Media accounts, you can instead use the relevant username such as RTGameCrowd.

  • The capitalisation must always stay the same.
    • RT is always to be capitalised.
    • The G and C in Game and Crowd respectively, should also be capitalised.

RT's real name (Daniel) should only be used in articles where this is relevant, such as talking about Daniel as a person. When using their real name, please write the name in full and avoid using any shortened variants of the name (Dan, etc).

Capital letters

TL;DR: Use common sense and lower case for everything unless it is a proper noun.

Avoid unnecessary capitalization. It is primarily needed for proper names, acronyms, and for the first letter of a sentence. Note that title text should always be ignored as they are often written in title case.

Below are a list of common nouns that should always be capitalized:

  • People names
  • Character names
  • Game names

Note that rare exception does occur, and can be discussed in the Discord if needed.

Spelling

British English should be used at all times. RTGame uses British, and so does the wiki.

Abbreviations

TL;DR: Try not to use abbreviations.

Abbreviations should only be used if it is defined in the article, and it does not affect the readability. Additional rules apply for article title as stated below:

  • Do not use abbreviations for article title unless there is no known full name.
  • Redirect acronyms and abbreviations to the article. The redirect page itself should be placed into Category:Abbreviations.
  • Create Disambiguation page if two or more different meanings for the abbreviations exist, instead of a redirect page.

Point of view

  • Third-person wherever possible
  • Use neutral, factual information
  • Avoid personal ideas and opinions

For example: "I Want Die is one of RTGames original Miis." not "I think I Want Die is the best Mii". Writing in this neutral tone will take practice, but it provides the readers with the most information and the least confusion.

Editorial notes

Please use the {{Note}} when it's necessary to make editorial comments.

Example:

Wiki Staff Editorial Note: As of 15-03-2021 RTGameCrowd on Twitch is now known as RTGame

Citations & references

First of all: please do cite references.

References should link back to official RTGame sources. Some examples of which include:

  • RTGame Twitch
  • Twitch Clips
  • RTGame Stream Archive Channel
  • RTGame Youtube
  • RTGame Twitter

Non-article styles

Disambiguation

Wikis must resolve ambiguous references when a link is to a term that has more than one distinct meaning. This process is called disambiguation.

When one term is clearly the more expected result, it can remain the primary link, and a {{for}} or {{about}} entry should head off the article. (See RTGame:Templates for examples.)

When it is not so clear, the term becomes a disambiguation page, linking to the possible meanings.

Alternate meanings take the form of Term (other meaning). (Note lower case for disambiguation meaning.) Alternative meanings should also have a for statement at the head of the article.


Talk and user pages

The writing style on community pages, such as talk pages and user pages, are more informal than content pages. This allows for easier, more friendly communication and a more familiar tone.

As with any personal-related content, respect is paramount when dealing with other editors and users. Insults, releasing personal information, or personal attacks will not be tolerated, even on your own user page. Please treat other editors with respect. They're people too!

See also


Note: A portion of the text above is originated from the Star Citizen Wiki under CC BY-SA 4.0 license.