Locked
Halopedia

Halopedia:Manual of Style: Difference between revisions

From Halopedia, the Halo wiki

m (→‎Page titles: a little expansion on this)
 
(110 intermediate revisions by 31 users not shown)
Line 1: Line 1:
<center>''For more general information, see the [[wikipedia:Wikipedia:Manual of Style|Wikipedia Manual of Style]].''</center>
{{Status|Halopedia}}
{{guideline}}
{{Center|For the layout style guide, see [[Halopedia:Layout guide]].}}
{{shortcut|HP:MOS}}
{{Policy}}


This '''Manual of Style''' for '''Halopedia''' is a guide for editors on how to properly format Halopedia articles.  
This '''Manual of Style''' is a guide applicable to all {{SITENAME}} articles. It reflects {{SITENAME}}'s standards, and is intended to help editors to produce articles with language, layout, and formatting that are consistent, clear, and precise. The goal of {{SITENAME}} is to make the whole encyclopedia easier, intuitive to use and the most definitive source for all Halo information.


== General ==
== General ==
#Please categorize articles and insert navigational templates appropriately to ensure that Halopedia is a more orderly compendium of Halo knowledge.
=== Editing ===
#Please do not insert a heading, such as <nowiki>== Summary ==</nowiki>, if there is only a single heading within the article. Just don't put a heading until you feel the need to insert two, and then you may create two.
It is recommended that you should know how to perform copy editing and content editing. Copy editing requires the basic knowledge of the English language. This covers from correcting spelling and grammar errors, using the proper verbs tense and fixing common punctuation mistakes. On the other hand, content editing expands this knowledge by assessing whether the written content meets the standards of a good encyclopedic entry. Elements of a good encyclopedic entry are explored further in the following sections.
#Whenever inserting pictures in "thumb" format, such as <nowiki>[[Image:Random.jpg|thumb|left]]</nowiki>, be sure to add a caption like <nowiki>[[Image:Random.jpg|thumb|left|Caption goes here.]]</nowiki>.
#Refer to the Halo universe from a third-person perspective.
#List all references at the end articles. It should not be: <code>SPARTAN-117 said, and I quote this from Halo 2, "I need a weapon."</code> Instead, use the reference tag if necessary, or else, write: <code>"I need a weapon." (''[[Halo 2]]'', ''[[Cairo Station (Level)|Cairo Station]]'')</code>
#Refrain from using slashes whenever possible. Instead, work the word "or" into the sentence, or figure out some other way of stating it.


==Editing Standards==
=== Do not copy-paste content ===
=== Use the Minor Edit button ===
The best practice while editing the wiki is to avoid pasting the information you copied from a source. When it comes to article content, you should (learn to) rewrite the information you have come across in your research, using your own words, as opposed to copying the source word-for-word. Fragments of official content may be copied verbatim for the sake of quotations; however, they must also be presented as such.
As a corollary to the above, if you're making a minor edit (e.g. fixing a spelling error or tweaking formatting), check the "This is a minor edit" button below the Summary box before saving the page. Again, this will make things easier for the rest of us.


=== Use the Preview Button ===
=== Internal consistency ===
The preview button is right next to the save edit button, and is there for a reason. It's your own personal spell checker, link checker, whatever-else checker. Use it. Users that purposefully do not preview edits as to inflate their edit count are not well regarded amongst Halopedians, and you may find yourself in trouble with an administrator.
An overriding principle is that style and formatting choices should be consistent within a {{SITENAME}} article, though not necessarily throughout {{SITENAME}} as a whole. Consistency within an article promotes clarity and cohesion.


=== Don't link to the current page ===
=== Stability of articles ===
In other words, a page should not link to itself. If it is attempted, the link will simply turn into bold text.
Editors should not change an article from one guideline-defined style to another without a substantial reason unrelated to mere choice of style, and that revert-warring over optional styles is unacceptable. Where there is disagreement over which style to use in an article, start a discussion on the talk page of the article and try to find ways to overcome the issue.


=== Link once ===
=== Follow the sources ===
A given page should only contain one link to any other page. If a page links to [[Captain Jacob Keyes]] in one place, then that should be the ''only'' link to Captain Jacob Keyes on that page. Typically this link should be the first instance of the term in the article.
{{main|Project:Notability policy|Help:References}}
Many points of usage, such as the treatment of proper names, can be decided by observing the style adopted by high-quality sources. Unless there is a clear reason to do otherwise, follow the usage of reliable English-language secondary sources on the subject. If the sources can be shown to be unrepresentative of current English usage, follow current English usage instead—and consult more sources.


=== Don't use conversational style ===
=== Clarity ===
This is an information site. It should read like [[wikipedia:main page|Wikipedia]], not like your diary.
Writing should be clear and concise. Plain English works best: avoid jargon, and vague or unnecessarily complex wording. Remember, the encyclopedia is aimed at late high school, early college reading proficiency, and general educational levels. Articles should be fully comprehensible to non-specialists.


*Check your spelling and grammar. Don't use internet slang (ex. "How r u?" or "c u 2nite").  If you're not 100% sure about the way a word is spelled, type it into [http://www.google.com/ Google] or [http://dictionary.reference.com/ Dictionary.com]. If you know that you're not the strongest speller, compose your edits in a word processor like Microsoft Word or use Mozilla Firefox, which has spell-checking built in.
=== Nomenclature ===
*Don't use "smileys" or "emoticons".
There is tension between the academic approach that names and classifies by the perspective of the field, and the layman's approach that uses common names and classifies according to common practice. We should try to accommodate the layman's approach wherever possible and avoid needlessly field-specific jargon.
*Don't "reply" to content others have posted. If you think a particular point warrants discussion, post on the article's Discussion page. If you're 100% sure that something should be changed and don't think a discussion is necessary, just change it. Dialogue goes only on articles' Discussion pages or the forum.
*Never abbreviate the names of characters, places, or anything. Wherever possible, use the full name of a character the first time they are mentioned. After the first mention, you may refer to "Master Chief" as "the Chief" or "Captian Jacob Keyes" as "Keyes" and so forth.


=== Stubs ===
=== Capitalization ===
If you don't know enough information on a topic, or you know there's more, add a stub to it. To do so, try this:<br />
As a general rule, Halopedia follows the most common capitalization standard found in official canon material. If official sources provide contradictory information, the most common, most recent, or most grammatically correct spelling should be preferred depending on the nature of the subject in question.
<pre>{{stub}}</pre>
And people will know that it's a stub by looking at the stub category.


=== Don't sign your edits ===
In general, the second or subsequent words in article titles should not be capitalized unless the title is a proper noun that would always be capitalized, even in the middle of a sentence. For example, even though words such as "Frigate" or "Point Defense System" are capitalized in infoboxes in ''Halo: The Essential Visual Guide'', these should be considered secondary to the more grammatically correct lowercase spellings found in most canonical material. Likewise, while weapon names are capitalized in most of the games (e.g. "Plasma Rifle"), the wiki follows the lowercase renderings used in the novels ("plasma rifle"). It should be noted, however, that ''proper names'' and ''formal designations'' should be capitalized accordingly; thus, the descriptor "BR55HB SR battle rifle" is rendered in lower case, while the weapon's formal name "BR55 Heavy Barrel Service Rifle", uses capital letters. Similarly, proper names like "Warthog" or "Pelican" are invariably capitalized.
All contributions are appreciated, but if every user left their mark on every contribution they made, the Wiki would be nothing but signatures. If you've made an edit that you're particularly proud of (such as a transcript or screenshot), the correct place to take credit is on your own [[Wikipedia:User page|user page]]. If you do not have a user account, we respect your anonymity, but your edits will remain anonymous, too.
*The same applies for species names. Even though the names of alien species, such as "[[Sangheili]]" or "[[Forerunner]]", are invariably capitalized, "[[human]]" is not, following the standard in virtually all official sources.
*There are certain idiosyncrasies to Halopedia's capitalization standards which may not be immediately obvious from official fiction due to contradictions between different pieces of media. One of these is the capitalization of "Spartan". When referring to the [[SPARTAN programs]] in a formal sense, the word "SPARTAN" is written in all capitals. However, the soldiers produced by the programs are referred to only as "Spartans". This applies to the programs both as a whole and individually (e.g. the [[SPARTAN-II program]], which produced the Spartan-II supersoldiers). The same rules apply to the usage of the name [[MJOLNIR]].


=== Do sign your Talk posts ===
Because of the wiki's formatting, article titles are always capitalized on top of the page even if that term would not be capitalized in running text. For example, [[assault cannon]] is rendered as "Assault cannon" in the title. However, this does not mean that such descriptive titles should be spelled with a capital letter in running text. The same applies to the titling of image categories. For example, the image category for [[armor abilities]] should be titled [[:Category:Images of armor abilities]] rather than "Images of Armor abilities" despite the article's title appearing as "Armor abilities" on top of the page.
If you make a post on a ''discussion'' page, please sign it. If you have a user account, this is as easy as typing <nowiki>~~~~</nowiki> at the end of your post. If you don't have a user account, just sign it with your name or nickname so everybody can tell who's who when reading long conversations. Even better, create an account anyway and use the signature method described. There really is no reason not to if you're going to stick around.


=== External Links ===
=== Styles ===
External links are links that point to sites other than the Wiki. The links should be in the form of a bulleted list. External links typically look like this:
Much of the styles you see in this manual of style is based on Wikipedia's [[wikipedia:Wikipedia:Manual of Style|manual of style]], however in some cases Halopedia will differ from Wikipedia. You can find a more detailed guide of this in the [[Project:Layout guide|layout guide]] The following specific style conventions will be used by Halopedia:
<pre>*[http://www.bungie.net/filename.html Something Something]</pre>


==Article Standards==
*'''Spelling''': *Halopedia has no preference as to whether to use [[wikipedia:American English|American English]] or [[wikipedia:British English|British English]] - however, once one style is defined within an article it should be employed consistently. Article titles, however, still preference American spellings.
The purpose of standardising all articles to an official format is to improve the quality and readability of all articles in Halopedia. That said, all users must follow the official format.
*'''Italics''': titles of any media and ships in the Halo universe should always be italicized (i.e. ''Halo 3'', ''The Art of Halo'', ''Halo: Landfall'', UNSC ''Forward Unto Dawn'', ''Truth and Reconciliation''). An exception to this would be those for [[Help:References|citation purposes]].
*'''Boldface''': in any article introduction, the article's title/name must be '''bolded'''. The introduction title/name should not have links within them.
*'''Measurement''': unless presented as such, always use the [[wikipedia:Metric system|Metric system]] over [[wikipedia:United States customary units|US customary units]] as the primary measurement. Make sure to present the US customary units in brackets after the metric system (i.e. 130&nbsp;kg (286&nbsp;lbs), 2.18 meters (7'2")).


===Levels===
=== Perspectives in articles ===
{{Level infobox
Articles in Halopedia use two perspectives: '''In-universe''' and '''Real-world'''.
|name={{PAGENAME}}
}}


====Summary/Brief Introduction====
Articles and sections written from an in-universe point of view are presented as though the information in canon sources were factual, much like how record-keepers within the ''Halo'' universe might document their world and the events within (similar to in-universe records like the ''[[CAA Factbook]]'' or ''[[The Punished Deeds]]''). However, Halopedia's point of view is that of a neutral observer rather than any particular group. "Past" events should always be narrated in the past tense (with the exception of [[:Category:Timeline|timeline]] articles, which are written in the present tense). However, subjects that remain in existence as of most recent knowledge should be described in the present tense. This practice is based, on a fundamental level, on the presentation of canon material by 343 Industries; for example, most official reference materials (such as [[Halo Waypoint]]'s Universe articles) use the present tense when describing "existing" subjects. What constitutes the "present day" of the ''Halo'' universe is not fully defined, but in practice the "now" of the mainline narrative (as of 2017) is in the late 2550s even though the latest documented events in the ''Halo'' timeline technically take place as late as [[2610]].
A brief introduction of the level with a plot summary. Shouldn't be detailed.


====Transcripts====
Real-world content (that is, everything marked with the "Real World" era icon, as well as gameplay- and development-related sections in articles) use an out-of-universe perspective. For example, while [[Battle of Installation 00 (2559)]] seeks to present a neutral, broad picture of the events and is written in the past tense, the plot summary for ''[[Halo Wars 2]]'' relates the same events in the manner the narrative of the game presents them, and is written in the present tense. Similarly, in content written from a real-world perspective, more well-known nomenclature should take precedence; for example, in a section discussing gameplay strategies, it can be more apt to use "Elites" instead of "Sangheili". Do note that certain instances of "popular" terminology (e.g. titles such as "the Master Chief" and "the Arbiter" in reference to [[John-117]] and [[Thel 'Vadam]], respectively) are also proper in-universe terms and their use is perfectly acceptable in in-universe content as long as the subject's proper name has been previously established in the article's context.
Transcripts should be added with a Youtube Link embedded in such format <nowiki>[http://Youtube-link {Cutscene}]</nowiki>


====Behind the Scenes====
Phrases like "his ultimate fate is unknown" or "what happened to the ship after that is a mystery" should not be included in most cases in which the subject's fate is simply not covered in released media. However, if the subject's status is unknown to the characters ''in-universe'' (or has been specifically noted in official media), this is acceptable to mention in the article.
Includes characters involvement, production notes, etc. Shouldn't include weapons, vehicles or glitches.


:This section should also include link to walkthrough.
All articles are to be written in the third person; avoid addressing the reader directly as "you", etc. It is acceptable to make an exception to this on Walkthrough pages, which by their nature are written to guide the reader.


====Trivia====
=== Article focus and scope ===
Redundant trivia should be avoided. Glitches, Misc Information, and References should be added here.
As a general rule, content overlap between articles should be avoided. Wiki articles ideally form interlinked tree structures in which additional information on a given topic can be accessed through [[Help:Links|links]]. For example, a character's biography should only recount that character's involvement in an event, rather than every detail about the event itself beyond what is necessary to establish context. If the event has its own article, readers can learn more about the details of the event on its own page while the biography should focus on information that is most relevant to the character in question. This applies to other topics as well; for example, the article [[SPARTAN programs]] provides a concise summary of each supersoldier project while providing links to the articles covering each program more thoroughly.


====Gallery====
However, editors may apply their own discretion in balancing the level of detail covered by an article with the overall amount of information available on the subject. For example, the article for [[Hamish Beamish]] describes a rather trivial event in detail (i.e. Beamish's reaction to a fight between major characters) because there is so little information on the character. Meanwhile, the article for [[John-117]] does not record the Master Chief's actions with the same level of detail as information of that nature is better described in linked articles for battles and other events, or is simply of negligible importance.
All images should be included in the gallery section. Images should not be added in the above sections as it is messy.


----
=== Do not use conversational style ===
===Character===
As {{SITENAME}} is an open encyclopedia site, it should read like an [[wikipedia:online encyclopedia|online encyclopedia]]. To be more specific, it should be something like [[wikipedia:Wikipedia|Wikipedia]].
#Please name all character articles by their full known name, not their title/rank as well. For example, Sergeant Major Johnson's article is titled [[Avery Junior Johnson]], not Sergeant Major Avery Junior Johnson.


{{SPARTAN Infobox
*Check your spelling and grammar. Do not use internet slang (ex. "How r u?" or "c u 2nite"). If you are not 100% sure about the way a word is spelled, type it into <span class="plainlinks">[http://www.google.com/ Google]</span> or <span class="plainlinks">[http://dictionary.reference.com/ Dictionary.com]</span>. If you know that you are not the strongest speller, compose your edits in a word processor like Microsoft Word or use an Internet browser like Mozilla Firefox or Google Chrome, which has spell-checking built in.
|name={{PAGENAME}}
*Do not "reply" to content others have posted. If you think a particular point warrants discussion, post on the article's talk page. If you are 100% sure that something should be changed and do not think a discussion is necessary, just change it. Dialogue goes only on articles' talk pages or the forum.
}}
*Avoid using second-person narrative in articles. As noted earlier, this wiki should read like an encyclopedia.
*Wherever possible, use the full name of a character the first time they are mentioned. After the first mention, you may refer to "Master Chief" as "the Chief" or "Captain Jacob Keyes" as "Keyes" and so forth. It is acceptable to abbreviate the title in some cases, including names that are commonly abbreviated in official material, such as "UNSC" as opposed to "United Nations Space Command".


====Summary/Brief Introduction====
=== Page titles ===
A brief introduction about the character and his/her background. Shouldn't be detailed.
==== General ====
Halopedia's article titles aim to provide basic information about the subject, either in the form of its official name (if known) or a description given by editors if the subject is not identified in official media. For examples of the latter, see [[:Category:Articles with conjectural titles|here]]. If necessary, a description should be brief and informative, and any terms that are not proper nouns should not be capitalized.


====Biography====
In most cases, weapons and vehicles are titled with the item's formal designation or model number followed by its more colloquial, in-game moniker (as opposed to the full technical name, which is conveyed in the introductory section of the article). Examples of these titles include {{Pattern|Karo'etba|Ghost}} and [[BR55 battle rifle]]. Capitalization of terms in titles follows our capitalization policy, discussed in an earlier section of this article.
In chronological order. List out the character's history (involvement in the Human-Covenant War, early life, etc).


====Combat====
When possible, Covenant [[design pattern]] or Brute [[clan workshop]] names are favoured over the UNSC-given [[Type classification system|type-]] designations. This is to help present a more neutral point-of-view into the ''Halo'' universe as opposed to an explicitly human lens, and also for standardisation - as 343 Industries move forward, type-designations are being phased out in favour of design patterns and workshops. Typical page title formats prefer the ''XYZ''-pattern or XYZ Workshop and then the colloquial moniker - as detailed above. Nicknames (such as Ghost, Wraith, Spiker, Chopper etc) should remain capitalised, while descriptive terms (assault rifle, energy sword, battlecruiser, etc) should remain lower-case.
If it applies to the character, this section should be included. List out the character's combat style and attitude towards enemy/allies


====Identity/Appearance/Age====
==== Disambiguating titles ====
If it applies to the character, this section should be included. If "Identity" is needed, list out Bungie's production notes on the character's identity. If "Appearance" is needed, list out his/her appearances in either games, novels or other media.
If there are two or more subjects with the same name, it is necessary to disambiguate the article titles from one another. When disambiguating titles with bracketed addendums, in-universe subjects should always be treated as primary; for example, the page for the Covenant ship is titled ''[[Long Night of Solace]]'', while the level of the same name is disambiguated as ''[[Long Night of Solace (level)]]''. Note that exceptions to this policy can be made if the real-world subject is considerably more notable than its canonical counterpart; an example of this would be the titling of the real-world [[343 Industries]] and [[343 Industries (manufacturer)]] which, while an in-universe subject, is too obscure and canonically insignificant in comparison to the real company to take precedence. If two or more in-universe subjects share the same name, the more notable subject should be treated as primary; for example, the article title for the people named [[John]] is not disambiguated while [[John (newscaster)]] is.


In general, this section is to discuss and lay out "extra" information about the character's background/personality.
Separate disambiguation pages with the addendum ''"(disambiguation)"'' are used when there are more than two articles with the same title, with a link to the disambiguation page placed on top of the "primary" (i.e. non-disambiguated) article with that name.


====Trivia====
==== Definite and indefinite articles ====
Redundant trivia should be avoided. Glitches, Misc Information, and References should be added here.
In general, a definite ("the") or indefinite ("a"/"an") article should be included at the beginning of the title of a page only if at least one of the following conditions is met:


====Gallery====
# If a word with a definite article has a different meaning with respect to the same word without the article, the word with article can be used as the name of a page about that meaning, and the word without article can be used as the name of a separate page.
All images should be included in the gallery section. Images should not be added in the above sections as it is messy.
#: For example, a [[heretic]] is someone who has offended the [[Covenant religion]], while ''[[The Heretic]]'' is the first level of ''Halo 2''.
# If the definite or indefinite article would be capitalized in running text, then include it at the beginning of the page name. Otherwise, do not.
#:For example, ''[[The Arbiter]]'' includes the article "The", because sentences such as "In the level ''[[The Arbiter]]'', the player assumes the role of the [[Arbiter]]" are written with a capitalized "The".
#:On the contrary, [[Flood]] should not include the article "The", because sentences such as "The Halo Array was designed to eradicate the Flood" are written with a lowercase "the".


----
These conditions are sometimes met if the page name is:
===Weapon===
* the title of a work or publication, in-universe or not (e.g. ''[[The Forerunner Saga]]'', ''[[The Mona Lisa]]'', ''[[The Admiralty Manual of Seamanship Volume II]]'') or
{{Weapon Infobox
* the name of a game level (e.g. ''[[The Truth and Reconciliation]]'', ''[[The Ark (level)]]'') or
| name={{PAGENAME}}
* another official or commonly used proper name which invariably includes the definite article.
}}


====Summary/Brief Introduction====
==== Title template ====
A brief introduction about the weapon's origin. Shouldn't be detailed.
The wiki uses [[:Template:Title]] to alter an article title or portions thereof. The most common application is the addition of italics to media titles or ship names. However, the template is ''not'' to be used to make changes to the title itself; e.g. bracketed addenda used for disambiguation should not be hidden, or extra terms (such as "The") shouldn't be added. This is to maintain clarity as to the article's actual title.


====Design details====
=== Linking and redirects ===
Includes the description and operation of the weapon.  
''Redirects are your friend.'' When linking to pages, it is unnecessary to avoid using redirects if they are available. For example, it is perfectly acceptable to link to the [[United Nations Space Command]] page as follows: <code><nowiki>[[UNSC]]</nowiki></code> rather than <code><nowiki>[[United Nations Space Command|UNSC]]</nowiki></code> (a "piped link"). There are several reasons for this, the most obvious being the immediate benefit of less extra clutter on the page as well as the fact using redirects is not harmful in any way. Additionally, if the title of an article section is changed, it is much less burdensome to change a single redirect page linking to that section than change all links to that section in many articles. Also, if the redirect is at some later point made into its own page, one does not need to change all links directing there because they were piped to the former parent article.


=====Ammunitions=====
Also note that it is not necessary to use a piped link to convert the first letter of a title to lower case: use <code><nowiki>[[signal flare]]</nowiki></code> instead of <code><nowiki>[[Signal flare|signal flare]]</nowiki></code>. Both function identically, as the wiki treats the first letter of a link as case-insensitive.
Describes the type of ammunition used by the weapon. Applicable only to rifles, pistols, etc.


=====Accuracy=====
It is also unnecessary to use piped links when only a given part of a term is linked, as long as the rest of the term is not separated from the linked portion (wikilinks automatically convert the rest of the word into a link). For example, <code><nowiki>[[human]]ity</nowiki></code> is shown as [[human]]ity, or <code><nowiki>[[Thel 'Vadam]]ee</nowiki></code> as [[Thel 'Vadam]]ee.
Only applicable if the accuracy differs significantly throughout the series. Outlines the accuracy issues by the weapon.


=====Advantages=====
===Article size rule===
As per title, advantages only. Strategy should be removed.
When deciding as to whether an article should be divided, please refer to the following table.


=====Disadvantages=====
{| cellspacing="0" cellpadding="0" style="background:transparent;"
As per title, disadvantages only. Strategy and tips should be removed.
|-
| style="vertical-align:top; text-align:center;"| '''Readable prose size''' || '''What to do'''
|-
| style="vertical-align:top; text-align:center;"| &gt; 100 KB || Almost certainly should be divided
|-
| style="vertical-align:top; text-align:center;"| &gt; 60 KB || Probably should be divided (although the scope of a topic can sometimes justify the added reading time)
|-
| style="vertical-align:top; text-align:center;"| ≥ 40 KB || May need to be divided (likelihood goes up with size)
|-
| style="vertical-align:top; text-align:center;"| &lt; 40 KB || Length alone does not justify division
|-
| style="vertical-align:top; text-align:center; width:10%;"| &lt; 1 KB || If an article or list has remained this size for over a couple of months, consider combining it with a related page. Alternatively,  why not fix it by adding more info? See [[wikipedia:Stub]].
|}


=====Influence=====
== Editing ==
If applicable only if it has relations to the real world or to the species' culture.
=== Avoid making multiple edits in an article ===
While Halopedia encourages editing of articles, an [[Halopedia:Blocking policy#Editing a page too many times in a short period of time|excessive amount]] of saved edits on a single article may be seen as spam. As such, a maximum of three successive edits in an article is acceptable within a short amount of time; regardless of the editor's intent, exceeding this limit may be seen as an attempt to spam and a staff member will inform you to stop and explain the scenario. If the staff member is ignored it may result in a ban for up to a week to a few months, depending on the extent of the infraction.


====Tactics====
A simple way of avoiding this problem is to practice using the Preview button which allows you to review the contributions you made before saving them.
Brief description of tactics for the weapon.
=====Campaign=====
Campaign tactics listed here. Should be brief and straight-forward.


=====Multiplayer=====
=== Use the minor edit button ===
Multiplayer (Online and Offline) tactics listed here. Should be brief and straight-forward.
If you are making a minor edit (e.g. fixing a spelling error or tweaking formatting), check the "This is a minor edit" button below the Summary box before saving the page. Again, this will make things easier for the rest of us.


=====Advanced Tactics=====
=== Use the preview button ===
Covers the miscellaneous/extra information. Should be brief and straight-forward.
The preview button is right next to the save edit button, and is there for a reason. It's your own personal spell checker, link checker, whatever-else checker. Use it. Users that purposefully do not preview edits as to inflate their edit count are not well regarded amongst Halopedians, and you may find yourself in trouble with an administrator.


====Trivia====
=== Always use the summary box ===
Redundant trivia should be avoided. Glitches, Misc Information, and References should be added here.
Before you touch that "Save page" button, ''always'' fill in the "Summary" box above the Save/Preview buttons before saving, and make sure that you fill it in with something useful describing the edit you made and, if it's not obvious, why. For example, "fixed spelling error" or "added fun fact" or "reverted from troll 127.0.0.1" are all acceptable. Saying "made some changes" or just filling in the name of the page is not helpful, because it's information that we already have.


====Gallery====
Making your summaries accurate and useful makes it vastly easier for the rest of us to keep track of [[Special:Recentchanges|Recent Changes]] and keeps everybody happy.
All images should be included in the gallery section. Images should not be added in the above sections as it is messy.


----
=== Do not sign your edits ===
===Military Unit===
All contributions are appreciated, but if every user left their mark on every contribution they made, the wiki would be nothing but signatures. If you have made an edit that you are particularly proud of (such as a transcript or screenshot), the correct place to take credit is on your own [[wikipedia:User page|user page]]. If you do not have a user account, we respect your anonymity, but your edits will remain anonymous, too.
{{Infobox Military Unit
|unit_name=Subtank/Update
}}


====Background====
=== Do sign your talk posts ===
What type of unit this is, the actions they have taken, and a brief summary of their exploits.  
If you make a post on a ''discussion'' page, please sign it. If you have a user account, this is as easy as typing <code><nowiki>~~~~</nowiki></code> at the end of your post. If you do not have a user account, just sign it with your name or nickname so everybody can tell who is who when reading long conversations. Even better, create an account anyway and use the signature method described. There really is no reason not to if you are going to stick around.


====History====
=== Using images/files ===
The entire history of the unit, from conception to disbandment (if applicable).  
{{Main|Help:Images}}
*Add only [[Project:Canon policy|canon]] image, not screenshots from customized/tweaked canon games or mods.
*Avoid uploading pictures you don't have a purpose for, unless they can add to a subject gallery. Before uploading, read [[Help:Images]] for more information on image use.


====Subordinate Units====
== Layout ==
All subordinate units under the command of the topic unit.  
=== Stubs ===
If you do not know enough information on a topic, or you know there's more, add a stub to it. To do so, try this:
:<code><nowiki>{{stub}}</nowiki></code>
People will know the article is a stub by looking at the stub category. Generally the <code><nowiki>{{stub}}</nowiki></code> template is put at the top of the page.


====Personnel====  
=== Do not link to the current page ===
All personnel assigned to the topic unit.  
In other words, a page should not link to itself. If it is attempted, the link will simply turn into bold text.


=====Commissioned Officers=====
=== Link once ===
=====Non-commissioned Officers=====
A given section of sufficient size should only contain one link to any other page. If a page links to [[Captain Jacob Keyes]] in one place, then that should be the ''only'' link to Captain Jacob Keyes in that section. Typically this link should be the first instance of the term in the article.
=====Enlisted=====
 
====Equipment====
All equipment used by the topic unit.
 
====Trivia====
Redundant trivia should be avoided. Glitches, Misc Information, and References should be added here.
 
----
 
===Music/Song===
There is no official format for Music/Song articles except a brief overview/description of how the music/song is produced (Hoodwind, piano, Gregorian Chant, etc). Additionally, scenes where the music/song is played should be included.
 
Also, a Youtube video should be added to the article if available and a Music Template should be included at the end of the article. If a Youtube video is added, it should be in such code: <nowiki>[[Video:FILENAME|200px|right]]</nowiki>.
 
====Trivia====
Redundant trivia should be avoided. Glitches, Misc Information, and References should be added here.
 
----
 
===Starship===
{{Ship
|name={{PAGENAME}}
}}
 
====Background====
A brief summary of what the ship's mission is and the history.
 
====Operational History====
An extensive history of the history of that particular ship.  
 
====Complement====
=====Armaments=====
An extensive summary of the weaponry aboard the ship, including small arms lockers for Marines.
 
=====Aircraft=====
An extensive summary of the aircraft aboard the ship.
 
=====Marines=====
An extensive summary of that particular Marine contingent aboard the ship.
 
====Crew Members (Only for single ships)====
=====Command Crew=====
A list of all members serving with the Command Crew.
 
=====Officers=====
All officers serving aboard the ship.
 
=====Crewman=====
All crewman (enlisted) serving aboard the ship.
 
=====Marines=====
All Marines stationed aboard the ship.
 
=====Pilots=====
All Pilots stationed aboard the ship.
 
====Ships of the Line (Only for ship class)====
An extensive list of all ships in a particular class. i.e. the UNSC ''Pillar of Autumn'' was a ''Halcyon''-class Cruiser.  


The format for listing ships should be as followed:
=== External links ===
<pre>*{{UNSC Ship|SHIP NAME}} ('''Hull Classification Symbol - Hull Number''')</pre>
External links are links that point to sites other than the wiki. The links should be in the form of a bullet list. External links typically look like this:
<pre>[http://www.bungie.net/filename.html '''The Website''': ''Title of the article'']</pre>


====Trivia====
=== Headers/Headings ===
Redundant trivia should be avoided. Glitches, Misc Information, and References should be added here.
Never make a header title as links. Instead, use the [[Template:Main|Main Redirect Template]] and add it under the header. Additionally, avoid adding the Ref Tag to the header.


====Gallery====
==See also==
All images should be included in the gallery section. Images should not be added in the above sections as it is messy.
*[[wikipedia:Wikipedia:MOS|'''Wikipedia''':''Manual of Style'']]
*[[Project:Layout guide]]
*[[Project:Canon policy]]


{{Helplist}}
{{Halopedia HAGP}}


[[Category:Help]]
[[Category:Help]]
[[Category:Project Pages]]
[[Category:Halopedia]]

Latest revision as of 14:41, October 27, 2022

For the layout style guide, see Halopedia:Layout guide.
Main-Forerunner.png
This page is an official Halopedia policy
Please read through the policy below to familiarize yourself with our common practices and rules.
If you have any questions, suggestions, or complaints, please post them on the talk page.

This Manual of Style is a guide applicable to all Halopedia articles. It reflects Halopedia's standards, and is intended to help editors to produce articles with language, layout, and formatting that are consistent, clear, and precise. The goal of Halopedia is to make the whole encyclopedia easier, intuitive to use and the most definitive source for all Halo information.

General

Editing

It is recommended that you should know how to perform copy editing and content editing. Copy editing requires the basic knowledge of the English language. This covers from correcting spelling and grammar errors, using the proper verbs tense and fixing common punctuation mistakes. On the other hand, content editing expands this knowledge by assessing whether the written content meets the standards of a good encyclopedic entry. Elements of a good encyclopedic entry are explored further in the following sections.

Do not copy-paste content

The best practice while editing the wiki is to avoid pasting the information you copied from a source. When it comes to article content, you should (learn to) rewrite the information you have come across in your research, using your own words, as opposed to copying the source word-for-word. Fragments of official content may be copied verbatim for the sake of quotations; however, they must also be presented as such.

Internal consistency

An overriding principle is that style and formatting choices should be consistent within a Halopedia article, though not necessarily throughout Halopedia as a whole. Consistency within an article promotes clarity and cohesion.

Stability of articles

Editors should not change an article from one guideline-defined style to another without a substantial reason unrelated to mere choice of style, and that revert-warring over optional styles is unacceptable. Where there is disagreement over which style to use in an article, start a discussion on the talk page of the article and try to find ways to overcome the issue.

Follow the sources

Main articles: Project:Notability policy, Help:References

Many points of usage, such as the treatment of proper names, can be decided by observing the style adopted by high-quality sources. Unless there is a clear reason to do otherwise, follow the usage of reliable English-language secondary sources on the subject. If the sources can be shown to be unrepresentative of current English usage, follow current English usage instead—and consult more sources.

Clarity

Writing should be clear and concise. Plain English works best: avoid jargon, and vague or unnecessarily complex wording. Remember, the encyclopedia is aimed at late high school, early college reading proficiency, and general educational levels. Articles should be fully comprehensible to non-specialists.

Nomenclature

There is tension between the academic approach that names and classifies by the perspective of the field, and the layman's approach that uses common names and classifies according to common practice. We should try to accommodate the layman's approach wherever possible and avoid needlessly field-specific jargon.

Capitalization

As a general rule, Halopedia follows the most common capitalization standard found in official canon material. If official sources provide contradictory information, the most common, most recent, or most grammatically correct spelling should be preferred depending on the nature of the subject in question.

In general, the second or subsequent words in article titles should not be capitalized unless the title is a proper noun that would always be capitalized, even in the middle of a sentence. For example, even though words such as "Frigate" or "Point Defense System" are capitalized in infoboxes in Halo: The Essential Visual Guide, these should be considered secondary to the more grammatically correct lowercase spellings found in most canonical material. Likewise, while weapon names are capitalized in most of the games (e.g. "Plasma Rifle"), the wiki follows the lowercase renderings used in the novels ("plasma rifle"). It should be noted, however, that proper names and formal designations should be capitalized accordingly; thus, the descriptor "BR55HB SR battle rifle" is rendered in lower case, while the weapon's formal name "BR55 Heavy Barrel Service Rifle", uses capital letters. Similarly, proper names like "Warthog" or "Pelican" are invariably capitalized.

  • The same applies for species names. Even though the names of alien species, such as "Sangheili" or "Forerunner", are invariably capitalized, "human" is not, following the standard in virtually all official sources.
  • There are certain idiosyncrasies to Halopedia's capitalization standards which may not be immediately obvious from official fiction due to contradictions between different pieces of media. One of these is the capitalization of "Spartan". When referring to the SPARTAN programs in a formal sense, the word "SPARTAN" is written in all capitals. However, the soldiers produced by the programs are referred to only as "Spartans". This applies to the programs both as a whole and individually (e.g. the SPARTAN-II program, which produced the Spartan-II supersoldiers). The same rules apply to the usage of the name MJOLNIR.

Because of the wiki's formatting, article titles are always capitalized on top of the page even if that term would not be capitalized in running text. For example, assault cannon is rendered as "Assault cannon" in the title. However, this does not mean that such descriptive titles should be spelled with a capital letter in running text. The same applies to the titling of image categories. For example, the image category for armor abilities should be titled Category:Images of armor abilities rather than "Images of Armor abilities" despite the article's title appearing as "Armor abilities" on top of the page.

Styles

Much of the styles you see in this manual of style is based on Wikipedia's manual of style, however in some cases Halopedia will differ from Wikipedia. You can find a more detailed guide of this in the layout guide The following specific style conventions will be used by Halopedia:

  • Spelling: *Halopedia has no preference as to whether to use American English or British English - however, once one style is defined within an article it should be employed consistently. Article titles, however, still preference American spellings.
  • Italics: titles of any media and ships in the Halo universe should always be italicized (i.e. Halo 3, The Art of Halo, Halo: Landfall, UNSC Forward Unto Dawn, Truth and Reconciliation). An exception to this would be those for citation purposes.
  • Boldface: in any article introduction, the article's title/name must be bolded. The introduction title/name should not have links within them.
  • Measurement: unless presented as such, always use the Metric system over US customary units as the primary measurement. Make sure to present the US customary units in brackets after the metric system (i.e. 130 kg (286 lbs), 2.18 meters (7'2")).

Perspectives in articles

Articles in Halopedia use two perspectives: In-universe and Real-world.

Articles and sections written from an in-universe point of view are presented as though the information in canon sources were factual, much like how record-keepers within the Halo universe might document their world and the events within (similar to in-universe records like the CAA Factbook or The Punished Deeds). However, Halopedia's point of view is that of a neutral observer rather than any particular group. "Past" events should always be narrated in the past tense (with the exception of timeline articles, which are written in the present tense). However, subjects that remain in existence as of most recent knowledge should be described in the present tense. This practice is based, on a fundamental level, on the presentation of canon material by 343 Industries; for example, most official reference materials (such as Halo Waypoint's Universe articles) use the present tense when describing "existing" subjects. What constitutes the "present day" of the Halo universe is not fully defined, but in practice the "now" of the mainline narrative (as of 2017) is in the late 2550s even though the latest documented events in the Halo timeline technically take place as late as 2610.

Real-world content (that is, everything marked with the "Real World" era icon, as well as gameplay- and development-related sections in articles) use an out-of-universe perspective. For example, while Battle of Installation 00 (2559) seeks to present a neutral, broad picture of the events and is written in the past tense, the plot summary for Halo Wars 2 relates the same events in the manner the narrative of the game presents them, and is written in the present tense. Similarly, in content written from a real-world perspective, more well-known nomenclature should take precedence; for example, in a section discussing gameplay strategies, it can be more apt to use "Elites" instead of "Sangheili". Do note that certain instances of "popular" terminology (e.g. titles such as "the Master Chief" and "the Arbiter" in reference to John-117 and Thel 'Vadam, respectively) are also proper in-universe terms and their use is perfectly acceptable in in-universe content as long as the subject's proper name has been previously established in the article's context.

Phrases like "his ultimate fate is unknown" or "what happened to the ship after that is a mystery" should not be included in most cases in which the subject's fate is simply not covered in released media. However, if the subject's status is unknown to the characters in-universe (or has been specifically noted in official media), this is acceptable to mention in the article.

All articles are to be written in the third person; avoid addressing the reader directly as "you", etc. It is acceptable to make an exception to this on Walkthrough pages, which by their nature are written to guide the reader.

Article focus and scope

As a general rule, content overlap between articles should be avoided. Wiki articles ideally form interlinked tree structures in which additional information on a given topic can be accessed through links. For example, a character's biography should only recount that character's involvement in an event, rather than every detail about the event itself beyond what is necessary to establish context. If the event has its own article, readers can learn more about the details of the event on its own page while the biography should focus on information that is most relevant to the character in question. This applies to other topics as well; for example, the article SPARTAN programs provides a concise summary of each supersoldier project while providing links to the articles covering each program more thoroughly.

However, editors may apply their own discretion in balancing the level of detail covered by an article with the overall amount of information available on the subject. For example, the article for Hamish Beamish describes a rather trivial event in detail (i.e. Beamish's reaction to a fight between major characters) because there is so little information on the character. Meanwhile, the article for John-117 does not record the Master Chief's actions with the same level of detail as information of that nature is better described in linked articles for battles and other events, or is simply of negligible importance.

Do not use conversational style

As Halopedia is an open encyclopedia site, it should read like an online encyclopedia. To be more specific, it should be something like Wikipedia.

  • Check your spelling and grammar. Do not use internet slang (ex. "How r u?" or "c u 2nite"). If you are not 100% sure about the way a word is spelled, type it into Google or Dictionary.com. If you know that you are not the strongest speller, compose your edits in a word processor like Microsoft Word or use an Internet browser like Mozilla Firefox or Google Chrome, which has spell-checking built in.
  • Do not "reply" to content others have posted. If you think a particular point warrants discussion, post on the article's talk page. If you are 100% sure that something should be changed and do not think a discussion is necessary, just change it. Dialogue goes only on articles' talk pages or the forum.
  • Avoid using second-person narrative in articles. As noted earlier, this wiki should read like an encyclopedia.
  • Wherever possible, use the full name of a character the first time they are mentioned. After the first mention, you may refer to "Master Chief" as "the Chief" or "Captain Jacob Keyes" as "Keyes" and so forth. It is acceptable to abbreviate the title in some cases, including names that are commonly abbreviated in official material, such as "UNSC" as opposed to "United Nations Space Command".

Page titles

General

Halopedia's article titles aim to provide basic information about the subject, either in the form of its official name (if known) or a description given by editors if the subject is not identified in official media. For examples of the latter, see here. If necessary, a description should be brief and informative, and any terms that are not proper nouns should not be capitalized.

In most cases, weapons and vehicles are titled with the item's formal designation or model number followed by its more colloquial, in-game moniker (as opposed to the full technical name, which is conveyed in the introductory section of the article). Examples of these titles include Karo'etba-pattern Ghost and BR55 battle rifle. Capitalization of terms in titles follows our capitalization policy, discussed in an earlier section of this article.

When possible, Covenant design pattern or Brute clan workshop names are favoured over the UNSC-given type- designations. This is to help present a more neutral point-of-view into the Halo universe as opposed to an explicitly human lens, and also for standardisation - as 343 Industries move forward, type-designations are being phased out in favour of design patterns and workshops. Typical page title formats prefer the XYZ-pattern or XYZ Workshop and then the colloquial moniker - as detailed above. Nicknames (such as Ghost, Wraith, Spiker, Chopper etc) should remain capitalised, while descriptive terms (assault rifle, energy sword, battlecruiser, etc) should remain lower-case.

Disambiguating titles

If there are two or more subjects with the same name, it is necessary to disambiguate the article titles from one another. When disambiguating titles with bracketed addendums, in-universe subjects should always be treated as primary; for example, the page for the Covenant ship is titled Long Night of Solace, while the level of the same name is disambiguated as Long Night of Solace (level). Note that exceptions to this policy can be made if the real-world subject is considerably more notable than its canonical counterpart; an example of this would be the titling of the real-world 343 Industries and 343 Industries (manufacturer) which, while an in-universe subject, is too obscure and canonically insignificant in comparison to the real company to take precedence. If two or more in-universe subjects share the same name, the more notable subject should be treated as primary; for example, the article title for the people named John is not disambiguated while John (newscaster) is.

Separate disambiguation pages with the addendum "(disambiguation)" are used when there are more than two articles with the same title, with a link to the disambiguation page placed on top of the "primary" (i.e. non-disambiguated) article with that name.

Definite and indefinite articles

In general, a definite ("the") or indefinite ("a"/"an") article should be included at the beginning of the title of a page only if at least one of the following conditions is met:

  1. If a word with a definite article has a different meaning with respect to the same word without the article, the word with article can be used as the name of a page about that meaning, and the word without article can be used as the name of a separate page.
    For example, a heretic is someone who has offended the Covenant religion, while The Heretic is the first level of Halo 2.
  2. If the definite or indefinite article would be capitalized in running text, then include it at the beginning of the page name. Otherwise, do not.
    For example, The Arbiter includes the article "The", because sentences such as "In the level The Arbiter, the player assumes the role of the Arbiter" are written with a capitalized "The".
    On the contrary, Flood should not include the article "The", because sentences such as "The Halo Array was designed to eradicate the Flood" are written with a lowercase "the".

These conditions are sometimes met if the page name is:

Title template

The wiki uses Template:Title to alter an article title or portions thereof. The most common application is the addition of italics to media titles or ship names. However, the template is not to be used to make changes to the title itself; e.g. bracketed addenda used for disambiguation should not be hidden, or extra terms (such as "The") shouldn't be added. This is to maintain clarity as to the article's actual title.

Linking and redirects

Redirects are your friend. When linking to pages, it is unnecessary to avoid using redirects if they are available. For example, it is perfectly acceptable to link to the United Nations Space Command page as follows: [[UNSC]] rather than [[United Nations Space Command|UNSC]] (a "piped link"). There are several reasons for this, the most obvious being the immediate benefit of less extra clutter on the page as well as the fact using redirects is not harmful in any way. Additionally, if the title of an article section is changed, it is much less burdensome to change a single redirect page linking to that section than change all links to that section in many articles. Also, if the redirect is at some later point made into its own page, one does not need to change all links directing there because they were piped to the former parent article.

Also note that it is not necessary to use a piped link to convert the first letter of a title to lower case: use [[signal flare]] instead of [[Signal flare|signal flare]]. Both function identically, as the wiki treats the first letter of a link as case-insensitive.

It is also unnecessary to use piped links when only a given part of a term is linked, as long as the rest of the term is not separated from the linked portion (wikilinks automatically convert the rest of the word into a link). For example, [[human]]ity is shown as humanity, or [[Thel 'Vadam]]ee as Thel 'Vadamee.

Article size rule

When deciding as to whether an article should be divided, please refer to the following table.

Readable prose size What to do
> 100 KB Almost certainly should be divided
> 60 KB Probably should be divided (although the scope of a topic can sometimes justify the added reading time)
≥ 40 KB May need to be divided (likelihood goes up with size)
< 40 KB Length alone does not justify division
< 1 KB If an article or list has remained this size for over a couple of months, consider combining it with a related page. Alternatively, why not fix it by adding more info? See wikipedia:Stub.

Editing

Avoid making multiple edits in an article

While Halopedia encourages editing of articles, an excessive amount of saved edits on a single article may be seen as spam. As such, a maximum of three successive edits in an article is acceptable within a short amount of time; regardless of the editor's intent, exceeding this limit may be seen as an attempt to spam and a staff member will inform you to stop and explain the scenario. If the staff member is ignored it may result in a ban for up to a week to a few months, depending on the extent of the infraction.

A simple way of avoiding this problem is to practice using the Preview button which allows you to review the contributions you made before saving them.

Use the minor edit button

If you are making a minor edit (e.g. fixing a spelling error or tweaking formatting), check the "This is a minor edit" button below the Summary box before saving the page. Again, this will make things easier for the rest of us.

Use the preview button

The preview button is right next to the save edit button, and is there for a reason. It's your own personal spell checker, link checker, whatever-else checker. Use it. Users that purposefully do not preview edits as to inflate their edit count are not well regarded amongst Halopedians, and you may find yourself in trouble with an administrator.

Always use the summary box

Before you touch that "Save page" button, always fill in the "Summary" box above the Save/Preview buttons before saving, and make sure that you fill it in with something useful describing the edit you made and, if it's not obvious, why. For example, "fixed spelling error" or "added fun fact" or "reverted from troll 127.0.0.1" are all acceptable. Saying "made some changes" or just filling in the name of the page is not helpful, because it's information that we already have.

Making your summaries accurate and useful makes it vastly easier for the rest of us to keep track of Recent Changes and keeps everybody happy.

Do not sign your edits

All contributions are appreciated, but if every user left their mark on every contribution they made, the wiki would be nothing but signatures. If you have made an edit that you are particularly proud of (such as a transcript or screenshot), the correct place to take credit is on your own user page. If you do not have a user account, we respect your anonymity, but your edits will remain anonymous, too.

Do sign your talk posts

If you make a post on a discussion page, please sign it. If you have a user account, this is as easy as typing ~~~~ at the end of your post. If you do not have a user account, just sign it with your name or nickname so everybody can tell who is who when reading long conversations. Even better, create an account anyway and use the signature method described. There really is no reason not to if you are going to stick around.

Using images/files

Main article: Help:Images
  • Add only canon image, not screenshots from customized/tweaked canon games or mods.
  • Avoid uploading pictures you don't have a purpose for, unless they can add to a subject gallery. Before uploading, read Help:Images for more information on image use.

Layout

Stubs

If you do not know enough information on a topic, or you know there's more, add a stub to it. To do so, try this:

{{stub}}

People will know the article is a stub by looking at the stub category. Generally the {{stub}} template is put at the top of the page.

Do not link to the current page

In other words, a page should not link to itself. If it is attempted, the link will simply turn into bold text.

Link once

A given section of sufficient size should only contain one link to any other page. If a page links to Captain Jacob Keyes in one place, then that should be the only link to Captain Jacob Keyes in that section. Typically this link should be the first instance of the term in the article.

External links

External links are links that point to sites other than the wiki. The links should be in the form of a bullet list. External links typically look like this:

[http://www.bungie.net/filename.html '''The Website''': ''Title of the article'']

Headers/Headings

Never make a header title as links. Instead, use the Main Redirect Template and add it under the header. Additionally, avoid adding the Ref Tag to the header.

See also