Star Trek Online Wiki
No edit summary
(→‎Linking: text moved from Help:Contents)
 
(36 intermediate revisions by 5 users not shown)
Line 1: Line 1:
  +
{{shortcut|STOW:STYLE}}
==Article Naming==
 
  +
{{guidelines}}
  +
{{guideline}}
   
  +
This guideline discusses best practices with regard to the writing style. We strive to achieve a consistent style across all articles. This however is only a guideline, not a policy. Violations against these suggestions should be corrected, but not frowned upon (see also [[Project:Please_do_not_bite_the_newcomers|Please do not bite the newcomers]] guideline).
The folowing naming conventions must be observed when naming certain articles:
 
  +
  +
== Tense ==
  +
All articles discussing in-game elements or aspects are written from a [[2409]] perspective. That means, that in general we use the present tense, as a contemporary encyclopedia does. Articles about [[Cryptic Studios]] or other meta-elements like the [[C-Store]] are written in a contemporary style, i.e. present tense for ongoing and current developments, past tense for completed and past developments and future tense for announcements etc. Articles that are specific to the [[STOWiki]] like the [[Main Page]], these guidelines or talk pages should also use the present tense where appropriate.
  +
  +
== Neutral style ==
  +
Outside of [[:Category:Guides|guides]], [[:Category:Mission walkthroughs|walkthroughs]] and talk pages, which are intended to give room for personal and subjective opinions, adhere to a neutral point of view. E.g. do not evaluate an item or ability when presenting it upfront. You may however add some information on its usefulness and relation to others of its kind in a ''Notes'' sub-section. This however should be backed not only by your personal opinion, but by external references like a profound forum discussion or a developer interview. Of course you can also present original research, but base your findings transparently on numbers, that everyone can reproduce.
  +
  +
== Addressing the reader ==
  +
Using second-person pronouns (''you'', ''your'') is discouraged in articles with an in-game (e.g. items, skills, NPCs) or meta-game (e.g. a developer article, user interface, C-Store) subject. Try to find a neutral point of view and talk about the player in the third person. For example ''"the player's starship"'' instead of ''"your starship"''. Also try to differentiate between the player and the character. So in an article you might want to elaborate on ''"the character's health"'' instead of ''"the player's health"''.
  +
  +
In guidelines, project pages and talk pages using second-person pronouns is however strongly encouraged.
  +
 
== Article titles ==
  +
In general, we prefer singular, lower case article names, if the game does not use the article title as a proper name. Article titles must not contain capitalized words unless they are proper nouns, such as "Federation", "Cardassian", "Sulu", ranks (when used as part of name), and "Spacedock" in the phrase "Earth Spacedock" (because it is itself a proper noun consisting of more than one word, each of which must be capitalized. Item names may be capitalized as they are in the game.
  +
  +
So for example an article would be named ''[[bridge officer]]'', not ''bridge officers'' or ''Bridge Officers''. Items are capitalized as in the game: ''[[Tribble of Borg]]'' instead of ''tribble of borg'' or ''Tribble Of Borg''. Locations are generally capitalized: ''[[Sol System]]'' instead of ''Sol'' or ''Sol system''; ''[[Fluidic Space]]'' instead of ''fluidic space''; ''[[Alpha Quadrant]]'' instead of ''alpha quadrant'' or ''Alpha quadrant''. Article titles must not contain ranks for characters in the game. For example, ''[[Jorel Quinn]]'' instead of ''Admiral Quinn''.
  +
  +
The first occurrence of the article title (or a variant thereof, e.g. plural) in the article itself must be in '''bold'''. An exception are NPCs, who are always addressed with their rank in-game For example, in the article for [[Zihr]] starts with "'''Ensign Zihr''' is..." instead of "Ensign '''Zihr''' is...".
  +
  +
In order to distinguish identically named entities like the [[Accolade]] ''{{accolade|Lucky}}'' and the [[Trait]] ''{{trait|Lucky}}'' the respective articles get separate prefixes.
   
 
{| class="wikitable"
 
{| class="wikitable"
Line 10: Line 32:
 
| NPCs (non-player characters)
 
| NPCs (non-player characters)
 
| (None)
 
| (None)
| '''/wiki/Golos Vell'''
+
| [[Golos Vell]]
 
|-
 
|-
  +
| Starships
| Items
 
| (None)
+
| (Prefix) (Name)
  +
| [[U.S.S. Oakland]]
| '''/wiki/Firearms Engineering Mk II'''
 
 
|-
 
|-
 
| Missions
 
| Missions
 
| Mission:(space)
 
| Mission:(space)
| '''/wiki/Mission: Azure Blues'''
+
| [[Mission: Stranded In Space]]
 
|-
 
|-
  +
| Items (all)
| Equipment
 
| Equipment:(space)
+
| (None)
  +
| [[Disruptor Dual Pistols]]
| '''/wiki/Equipment: Pollyalloy Weave Mk VIII'''<br>''(Must also be placed within category "Body Armor" because the equipment name is preceded by that phrase within the game.)''
 
  +
|-
  +
| Skills (all)
  +
| Skill:(space)
  +
| [[Skill: Tactical Team Leader]]
  +
|-
  +
| Trait (all)
  +
| Trait:(space)
  +
| [[Trait: Leadership]]
 
|-
 
|-
  +
| Injury (all)
| Kits
 
| Kit:(space)
+
| Injury:(space)
  +
| [[Injury: Minor Concussion]]
| '''/wiki/Kit: Firearms Engineering Mk II'''<br>''(Must also be placed within category "Engineering Kits" because the kit name is preceded by "Engineering Kit" in the game.)''
 
 
|-
 
|-
  +
| Accolade (all)
| Weapons
 
| Weapon:(space)
+
| Accolade:(space)
  +
| [[Accolade: Affluent]]
| '''/wiki/Weapon: Arcwave MK VIII'''<br>''(Must also be placed within category "Disruptor Bolt Assault Weapons", because the weapon name is preceded by that phrase within the game.)''
 
  +
|-
  +
| Guide (all)
  +
| Guide:(space)
  +
| [[Guide: Basics]]
 
|}
 
|}
   
==Article Linking==
+
=== Lists ===
  +
An exception from the article naming guideline on plural forms are lists. The most prominent example is the [[list of missions]].
  +
  +
=== Categories ===
  +
Categories should adhere to the usual article naming guidelines, but in fact many are not. The [[:Category: Federation Starships]] is such an example. Since it is a lot of work, to rename an established category with many members, users are encouraged to pay special attention to creating new categories.
   
  +
== Linking ==
 
For the following article types, the corresponding template must be used when linking to it:
 
For the following article types, the corresponding template must be used when linking to it:
   
Line 46: Line 85:
 
| <nowiki>[[Malcolm Sissel]]</nowiki>
 
| <nowiki>[[Malcolm Sissel]]</nowiki>
 
|-
 
|-
  +
| Starships
| Items
 
  +
| [[Template:USS|<nowiki>{{USS}}</nowiki>]], [[Template:IKS|<nowiki>{{IKS}}</nowiki>]], [[Template:IRW|<nowiki>{{IRW}}</nowiki>]]
| (None)
 
| <nowiki>[[Firearms Engineering Mk II]]</nowiki>
+
| <nowiki>{{USS|Oakland}}</nowiki>
 
|-
 
|-
 
| Missions
 
| Missions
| <nowiki>{{mission}}</nowiki>
+
| [[Template:mission|<nowiki>{{mission}}</nowiki>]]
| <nowiki>{{mission|Azure Blues}}</nowiki>
+
| <nowiki>{{mission|Assimilation}}</nowiki>
  +
|- valign="top"
 
| ALL Items
  +
| [[Template:item|<nowiki>{{item}}</nowiki>]]
  +
| <nowiki>{{item|Body Armor - Energy Dampening|Mk II|common}}</nowiki><br /><nowiki>{{item|Livanian Beet||common}}</nowiki>
 
|-
 
|-
  +
| Abilities
| Equipment
 
| <nowiki>{{equipment}}</nowiki>
+
| [[Template:ability|<nowiki>{{ability}}</nowiki>]]
| <nowiki>{{equipment|Body Armor|Energy Dampening Mk II|common}}</nowiki>
+
| <nowiki>{{ability|Evasive Maneuvers}}</nowiki>
 
|-
 
|-
| Kits
+
| Skills
| <nowiki>{{kit}}</nowiki>
+
| [[Template:skill|<nowiki>{{skill}}</nowiki>]]
| <nowiki>{{kit|Engineering Kit|Firearms Engineering Mk II|uncommon}}</nowiki>
+
| <nowiki>{{skill|Science Team Leader}}</nowiki>
 
|-
 
|-
| Weapons
+
| Traits
| <nowiki>{{weapon}}</nowiki>
+
| [[Template:trait|<nowiki>{{trait}}</nowiki>]]
| <nowiki>{{weapon|Disruptor Bolt Assault Weapon|Arcwave Mk VIII|uncommon}}</nowiki>
+
| <nowiki>{{trait|Cold Dwelling}}</nowiki>
  +
|-
  +
| Injuries
  +
| [[Template:injury|<nowiki>{{injury}}</nowiki>]]
  +
| <nowiki>{{injury|Minor concussion}}</nowiki>
  +
|-
  +
| Accolades
  +
| [[Template:accolade|<nowiki>{{accolade}}</nowiki>]]
  +
| <nowiki>{{accolade|Affluent}}</nowiki>
 
|}
 
|}
   
  +
* ''LINKING:'' Should a new entry be created on the STO Wiki? Or should it be linked to the Memory Alpha wiki? If it is a link-worthy article, but is only mentioned in passing, then link to Memory Alpha [[ma:Star Trek|like so]]. Otherwise, create a new article and/or add content to the article.
==Item InfoBoxes==
 
  +
* ''ONLY LINK ONCE:'' While we encourage linking as much relevant information as possible to new articles, only one link per page is necessary. So if the Romulans are referenced more than once, only the first reference may be linked.
[[File:EngineeringKit_FirearmsEngineeringMkII.png|250px|thumb|right|Sample in-game info box.]]
 
Like in the game, and as can be seen in the screenshot to the right, each item within the game has a specially formatted information box. This convention must be observed on this wiki as well; all items will have a corresponding info box. Here is how the process will work:
 
 
# On an item page, the template '''<nowiki>{{{iteminfobox|Item Article Title}}}</nowiki>''' is added.
 
# This template then calls up the article '''Infobox: Item Article Title''', which the user must populate with formatting to resemble the in-game information box.
 
 
For example, in the article '''Equipment: Personal Shield Mk II''', the following would appear at the top of the article, to insert its InfoBox:
 
 
<nowiki>{{iteminfobox|Personal Shield Mk II}}</nowiki>
 
 
This would then call up '''Infobox: Personal Shield Mk II''', which the user must then populate with the proper formatting as shown directly below.
 
 
===Item InfoBox Formatting===
 
* In the example above, the title is in a narrow green font, since the item is <span class="item uncommon">Uncommon</span>. To specify the infobox title, use the following formatting:
 
 
&lt;span class="itemtitle uncommon"&gt;Engineering Kit - Firearms Engineering Mk II&lt;/span&gt;
 
 
The '''itemtitle''' class specifies the correct font and size for the title, and the '''uncommon''' class formats the color for the corresponding rarity. Only use '''uncommon''', '''common''', ''epic''', and '''rare''' for the second class name.
 
 
* For the text directly below the title, "Uncommon Kit", use the following formatting:
 
 
&lt;span class="uncommon"&gt;Uncommon Kit&lt;/span&gt;
 
 
The '''uncommon''' class again colors it <span style="item uncommon">green</span> for being an Uncommon item.
 
 
* For all body text, simply use formatting only when the text is not plain white:
 
 
Bind On Pickup
 
&lt;span class="blue"&gt;KDF Engineer, Starfleet Engineer&lt;/span&gt;
 
...
 
 
...and so forth. The '''blue''' class simply colors the body text a light cyan color where shown.
 
 
* For subtitle text (such as "Quick Fix 1" and "Expose Attack" in the example above), use the following formatting:
 
 
&lt;span class="subtitle green"&gt;Quick Fix 1&lt;/span&gt;
 
 
and
 
 
&lt;span class="subtitle yellow"&gt;Expose Attack&lt;/span&gt;
 
 
* If there is a label for a required rank for item usage, specify it like so:
 
 
&lt;span class="rank"&gt;Captain&lt;/span&gt;
 
 
This will automatically right-align the text, as it is in the game's item information
 
boxes.
 
 
* To indent text as shown above, use regular wiki formatting:
 
 
<nowiki>:</nowiki>24 Hit Points to Fabrications
 
<nowiki>:</nowiki>25% chance: to self: AICommand
 
<nowiki>:</nowiki>...
 
 
This can be nested to indent on more than one level, like so:
 
 
<nowiki>:</nowiki>...
 
<nowiki>:</nowiki>to target: Applies &lt;span class="blue"&gt;Quick Fix Applied&lt;/span&gt; for 12 sec
 
<nowiki>:</nowiki><nowiki>:</nowiki>Removes up to 1 effects
 
<nowiki>:</nowiki>+9% All Damage strength to Ranged Weapons for 12 sec
 
<nowiki>:</nowiki>...
 
 
* Finally, for the cost of the item, use the following formatting:
 
 
&lt;span class="cost"&gt;2,285 <nowiki>{{EC}}</nowiki>&lt;/span&gt;
 
 
The '''<nowiki>{{EC}}</nowiki>''' template inserts the "Energy Credits" currency icon, like this: {{EC}}.
 
   
  +
== See also ==
* To view an example of how the above info box would be formatted in its entirety, please visit: [[Example: Item InfoBox Formatting]].
 
  +
* The guideline on [[Project:Formatting|formatting]]''

Latest revision as of 21:36, 22 May 2021

Icon-shortcut Shortcut: STOW:STYLE

Icon-policy STOWiki Guidelines

Assume good faith
Archival
Be bold!
Fan fiction
Formatting
Images
Manual of Style

PDBTN
Signatures
Subpages
Talk pages
Text removal
Foundry missions
Wikiquette

See also:
Policies Administrators
 
Guideline

This page is considered a guideline on STOWiki.

It illustrates standards of conduct, which many editors agree with in principle. However, it is not policy.

This guideline discusses best practices with regard to the writing style. We strive to achieve a consistent style across all articles. This however is only a guideline, not a policy. Violations against these suggestions should be corrected, but not frowned upon (see also Please do not bite the newcomers guideline).

Tense[]

All articles discussing in-game elements or aspects are written from a 2409 perspective. That means, that in general we use the present tense, as a contemporary encyclopedia does. Articles about Cryptic Studios or other meta-elements like the C-Store are written in a contemporary style, i.e. present tense for ongoing and current developments, past tense for completed and past developments and future tense for announcements etc. Articles that are specific to the STOWiki like the Main Page, these guidelines or talk pages should also use the present tense where appropriate.

Neutral style[]

Outside of guides, walkthroughs and talk pages, which are intended to give room for personal and subjective opinions, adhere to a neutral point of view. E.g. do not evaluate an item or ability when presenting it upfront. You may however add some information on its usefulness and relation to others of its kind in a Notes sub-section. This however should be backed not only by your personal opinion, but by external references like a profound forum discussion or a developer interview. Of course you can also present original research, but base your findings transparently on numbers, that everyone can reproduce.

Addressing the reader[]

Using second-person pronouns (you, your) is discouraged in articles with an in-game (e.g. items, skills, NPCs) or meta-game (e.g. a developer article, user interface, C-Store) subject. Try to find a neutral point of view and talk about the player in the third person. For example "the player's starship" instead of "your starship". Also try to differentiate between the player and the character. So in an article you might want to elaborate on "the character's health" instead of "the player's health".

In guidelines, project pages and talk pages using second-person pronouns is however strongly encouraged.

Article titles[]

In general, we prefer singular, lower case article names, if the game does not use the article title as a proper name. Article titles must not contain capitalized words unless they are proper nouns, such as "Federation", "Cardassian", "Sulu", ranks (when used as part of name), and "Spacedock" in the phrase "Earth Spacedock" (because it is itself a proper noun consisting of more than one word, each of which must be capitalized. Item names may be capitalized as they are in the game.

So for example an article would be named bridge officer, not bridge officers or Bridge Officers. Items are capitalized as in the game: Tribble of Borg instead of tribble of borg or Tribble Of Borg. Locations are generally capitalized: Sol System instead of Sol or Sol system; Fluidic Space instead of fluidic space; Alpha Quadrant instead of alpha quadrant or Alpha quadrant. Article titles must not contain ranks for characters in the game. For example, Jorel Quinn instead of Admiral Quinn.

The first occurrence of the article title (or a variant thereof, e.g. plural) in the article itself must be in bold. An exception are NPCs, who are always addressed with their rank in-game For example, in the article for Zihr starts with "Ensign Zihr is..." instead of "Ensign Zihr is...".

In order to distinguish identically named entities like the Accolade Lucky and the Trait Lucky the respective articles get separate prefixes.

Article Type Prefix Example
NPCs (non-player characters) (None) Golos Vell
Starships (Prefix) (Name) U.S.S. Oakland
Missions Mission:(space) Mission: Stranded In Space
Items (all) (None) Disruptor Dual Pistols
Skills (all) Skill:(space) Skill: Tactical Team Leader
Trait (all) Trait:(space) Trait: Leadership
Injury (all) Injury:(space) Injury: Minor Concussion
Accolade (all) Accolade:(space) Accolade: Affluent
Guide (all) Guide:(space) Guide: Basics

Lists[]

An exception from the article naming guideline on plural forms are lists. The most prominent example is the list of missions.

Categories[]

Categories should adhere to the usual article naming guidelines, but in fact many are not. The Category: Federation Starships is such an example. Since it is a lot of work, to rename an established category with many members, users are encouraged to pay special attention to creating new categories.

Linking[]

For the following article types, the corresponding template must be used when linking to it:

Article Type Template Example
NPCs (non-player characters) (None) [[Malcolm Sissel]]
Starships {{USS}}, {{IKS}}, {{IRW}} {{USS|Oakland}}
Missions {{mission}} {{mission|Assimilation}}
ALL Items {{item}} {{item|Body Armor - Energy Dampening|Mk II|common}}
{{item|Livanian Beet||common}}
Abilities {{ability}} {{ability|Evasive Maneuvers}}
Skills {{skill}} {{skill|Science Team Leader}}
Traits {{trait}} {{trait|Cold Dwelling}}
Injuries {{injury}} {{injury|Minor concussion}}
Accolades {{accolade}} {{accolade|Affluent}}
  • LINKING: Should a new entry be created on the STO Wiki? Or should it be linked to the Memory Alpha wiki? If it is a link-worthy article, but is only mentioned in passing, then link to Memory Alpha like so. Otherwise, create a new article and/or add content to the article.
  • ONLY LINK ONCE: While we encourage linking as much relevant information as possible to new articles, only one link per page is necessary. So if the Romulans are referenced more than once, only the first reference may be linked.

See also[]