Xenopedia
Register
Xenopedia
(36 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Policy}}
 
 
This '''Manual of Style''' outlines a standard of clean, consistent formatting for articles on Xenopedia. The formatting described here is a ''guideline'' and can be overridden where circumstances warrant it. These guidelines will never be perfect for every situation. However, please keep to the standard format outlined in this article so others may use your edits as an example when creating and editing other articles.
 
This '''Manual of Style''' outlines a standard of clean, consistent formatting for articles on Xenopedia. The formatting described here is a ''guideline'' and can be overridden where circumstances warrant it. These guidelines will never be perfect for every situation. However, please keep to the standard format outlined in this article so others may use your edits as an example when creating and editing other articles.
   
These guidelines are a summary of the most important guidelines for this wiki, but a more expansive set of style guidelines can be found at [[wikipedia:Wikipedia:Manual of Style|Wikipedia's Manual of Style]]. A sample article based off these guidelines can be found on [[Xenopedia:Manual of Style/Sample]].
+
These guidelines are a summary of the most important guidelines for this wiki, but a more expansive set of style guidelines can be found at [[wikipedia:Wikipedia:Manual of Style|Wikipedia's Manual of Style]]. If you are new to wikis, you may also like to read [[Help:Editing]]. A list of sample articles based off these guidelines can be found on the [[/Samples|samples page]].
   
 
Below are some basic ''Alien vs. Predator'' formatting do's and don't's.<!--There is much to add to this. Please add to it if you feel something should be addressed.-->
 
Below are some basic ''Alien vs. Predator'' formatting do's and don't's.<!--There is much to add to this. Please add to it if you feel something should be addressed.-->
Line 10: Line 9:
   
 
===Capital letters===
 
===Capital letters===
  +
All film, game, book, comic and character names should be written in title case, where all words are capitalised, except common short words such as "and", "the", "if", "of" or "in". Two short words that notably should be capitalized are "Is" and "It".
Please note that semi-sentient or non-sentient creature names should not start with a capital letter unless dictated otherwise by canon. For example, writing "Rhynth" instead of "[[rhynth]]" is agrammatical. As much as we would not capitalize "Dog" or "Cat" in real-life, we should not capitalize fictional creature names. A notable exception to this is the {{Xeno}}, which ''is'' capitalized, as "Xenomorph" is a shortening of "Xenomorph XX121", the creature's full, official name and a proper noun.
 
  +
 
Semi-sentient or non-sentient creature names should not start with a capital letter unless dictated otherwise by canon. For example, writing "Rhynth" instead of "[[rhynth]]" is agrammatical. As much as we would not capitalize "Dog" or "Cat" in real-life, we should not capitalize fictional creature names. A notable exception to this is the {{Xeno}}, which ''is'' capitalized, as "Xenomorph" is a shortening of "Xenomorph XX121", the creature's full, official name and a proper noun.
   
 
Military ranks, such as "corporal" or "private", should start with a capital letter: for example, use "Corporal [[Dwayne Hicks|Hicks]]", not "corporal Hicks". Ranks or titles aboard a ship should also start with a capital letter when used as a title: for example, use "Captain [[Dallas Arthur|Dallas]]", not "captain Dallas". However, when used generically, ship ranks should be in lower case, as in "Dallas was the captain of the ship."
 
Military ranks, such as "corporal" or "private", should start with a capital letter: for example, use "Corporal [[Dwayne Hicks|Hicks]]", not "corporal Hicks". Ranks or titles aboard a ship should also start with a capital letter when used as a title: for example, use "Captain [[Dallas Arthur|Dallas]]", not "captain Dallas". However, when used generically, ship ranks should be in lower case, as in "Dallas was the captain of the ship."
   
 
===Italics===
 
===Italics===
Italics should always be used for the titles of films, games, books and comics: for example, {{P2}} or ''[[Alien: River of Pain]]''. Likewise, the names of ships or space-going vessels should also always be written in italics; however, any prefix should be written without italics: for example {{USS|Sulaco}}.
+
Italics should always be used for the titles of films, games, books and comics: for example, {{P2}} or ''[[Alien: River of Pain]]''.
  +
 
====Ship and class names====
  +
Names of specific spacecraft should always be capitalized and should always written in italics; however, any prefix should be written without italics: for example {{USS|Sulaco}}. Ships should also be referred to using neutral pronouns (i.e. it, its).
  +
  +
The name of a ship class names should also be italicized. When a ship's class is a modifier, it should include a hyphen: "A ''Conestoga''-class transport". When it is a noun, is should not include a hyphen: "A ship of the ''Conestoga'' class".
  +
 
===Apostrophes and possessives ending in "s"===
 
While plural nouns ending in "s" should be made possessive by adding only an apostrophe, singular nouns ending in "s" can be made possessive by adding either an apostrophe followed by another "s" or simply an apostrophe, providing each article is consistent throughout.
  +
 
===Xenomorphs and gender===
  +
{{Xeno}}s are predominantly assumed to have no gender and therefore referred to as "it" or "them", with the exception of [[Queen (caste)|Queens]] which are often referred to as feminine. However, if a specific Xenomorph is referred to as "he" or "she" in [[Xenopedia:Canon|canon]], refer to them as such in their article.
  +
  +
===Yautja===
  +
The word {{Pred}} has an identical singular and plural, similar to the words "sheep" or "spacecraft". An "s" should not be added when referring to more than one Yautja.
   
 
==Article Layout==
 
==Article Layout==
Line 22: Line 37:
 
Organize sections in an article in a hierarchical structure like you would an outline. Keep it logical, but feel free to forsake strict logic for readability. Wherever necessary, use subsections to break up lengthy blocks of text and make the page easier and more inviting for people to read.
 
Organize sections in an article in a hierarchical structure like you would an outline. Keep it logical, but feel free to forsake strict logic for readability. Wherever necessary, use subsections to break up lengthy blocks of text and make the page easier and more inviting for people to read.
   
Above all, keep your layout consistent. Don't throw your reader a curve ball too often. Consistency, particularly across different articles, is one of the easiest ways to make a wiki appear more professional; if everything follows a similar pattern, it gives the impression of forward planning and oversight. The following sections will offer some good advice on keeping your articles clean, consistent, and clear.
+
Above all, keep your layout consistent. Don't throw your reader a curve ball too often. Consistency, particularly across different articles, is one of the easiest ways to make a wiki appear more professional; if everything follows a similar pattern, it gives the impression of forward planning and oversight. The example articles listed on the [[Xenopedia:Manual of Style/Samples|samples page]] will show you how to create a page that conforms with those already on Xenopedia, particularly with regards to the appropriate sections and headings you should try to include.
  +
  +
The following sections will also offer some good advice on keeping your articles clean, consistent, and clear.
   
 
===Main page/see also===
 
===Main page/see also===
Some pages may contain a brief summary of information that is elaborated on elsewhere on a dedicated page. To direct the user to the main page, type <nowiki>{{Main|}}</nowiki> and enter the name of the main page itself after the bar, like this — <nowiki>{{Main|Chestburster}}</nowiki>. The result will be:
+
Some pages may contain a brief summary of information that is elaborated on elsewhere on a dedicated page. To direct the user to the main page, type <tt><nowiki>{{Main|}}</nowiki></tt> and enter the name of the main page itself after the bar, like this — <tt><nowiki>{{Main|Chestburster}}</nowiki></tt>. The result will be:
   
 
{{Main|Chestburster}}
 
{{Main|Chestburster}}
   
Similarly, you may wish to link to an article that contains related information but is not specifically dedicated to the topic at hand. In those instances, use the <nowiki>{{See|}}</nowiki> template exactly as you would above. For example, <nowiki>{{See|Plasma Caster}}</nowiki> will give:
+
Similarly, you may wish to link to an article that contains related information but is not specifically dedicated to the topic at hand. In those instances, use the <tt><nowiki>{{See|}}</nowiki></tt> template exactly as you would above. For example, <tt><nowiki>{{See|Plasma Caster}}</nowiki></tt> will give:
   
 
{{See|Plasma Caster}}
 
{{See|Plasma Caster}}
Line 36: Line 53:
 
A table of contents is automatically added to articles that have at least four headings. However, you may wish to insert a table of contents into a longer article that has fewer headings, to make it easier for readers to navigate. You may also wish to remove a table of contents from a page; while this is generally not a good idea, it may be beneficial in some cases. To add or remove a table of contents, type the following at the top of the page, after the opening section:
 
A table of contents is automatically added to articles that have at least four headings. However, you may wish to insert a table of contents into a longer article that has fewer headings, to make it easier for readers to navigate. You may also wish to remove a table of contents from a page; while this is generally not a good idea, it may be beneficial in some cases. To add or remove a table of contents, type the following at the top of the page, after the opening section:
   
To add a TOC: <nowiki>__TOC__</nowiki>
+
To add a table of contents: <tt><nowiki>__TOC__</nowiki></tt><br>
To remove the TOC: <nowiki>__NOTOC__</nowiki>
+
To remove the table of contents: <tt><nowiki>__NOTOC__</nowiki></tt>
   
 
===Section headings===
 
===Section headings===
 
You can make a section header by typing two "equal" signs, the title of the header, and then two more "equal" signs, for example:
 
You can make a section header by typing two "equal" signs, the title of the header, and then two more "equal" signs, for example:
   
<nowiki>==Example==</nowiki>
+
<tt><nowiki>==Example==</nowiki></tt>
   
 
To make subsections, use progressively more equal signs. For example:
 
To make subsections, use progressively more equal signs. For example:
   
<nowiki>===Subsection of Example===</nowiki>
+
<tt><nowiki>===Subsection of Example===</nowiki></tt>
   
 
Do not use links in subject headings. Instead, consider putting the relevant link in the first or second sentence of the section and linking it there. Alternatively, the main page or see also templates can be placed directly beneath the heading.
 
Do not use links in subject headings. Instead, consider putting the relevant link in the first or second sentence of the section and linking it there. Alternatively, the main page or see also templates can be placed directly beneath the heading.
   
Section headings should be capitalized. For example, use "Personality and Traits", not "Personality and traits". Subsection headings should only capitalize the first word and of any proper nouns.
+
Section headings should be capitalized. For example, use "Personality and Traits", not "Personality and traits". Subsection headings should only capitalize the first word and any proper nouns.
   
Avoid using special characters in headings, such as an ampersand (&), a plus sign (+), curly braces ({}), or square braces ([]). In place of the ampersand, use the word "and", unless the ampersand is part of a formal name.
+
Avoid using special characters in headings, such as an ampersand (<tt>&</tt>), a plus sign (<tt>+</tt>), curly braces (<tt>{}</tt>), or square braces (<tt>[]</tt>). In place of the ampersand, use the word "and", unless the ampersand is part of a formal name.
   
Always keep headings short and simple. Headings are guidelines to your page's structure and should inform the reader rather than confuse. To keep it short, avoid unnecessary words or redundancy in headings, i.e. avoid a, an and the, pronouns, repeating the article title, and so on. Also, try to avoid giving identical titles to different sections.
+
Always keep headings short and simple. Headings are guidelines to your page's structure and should inform the reader rather than confuse. To keep it short, avoid unnecessary words or redundancy in headings (i.e. avoid a, an and the, pronouns, repeating the article title, and so on). Also, try to avoid giving identical titles to different sections.
   
 
===Images===
 
===Images===
  +
{{See|Help:Images}}
 
[[Image:Example.jpg|thumb|right|Caption]]
 
[[Image:Example.jpg|thumb|right|Caption]]
 
Images make an article memorable and attractive. Pictures can speak where words fail. At the same time, misplaced or untidy images can take away from an article. When choosing images, keep in mind placement, size, and the appropriateness of the image to the section. Let images flow with the text instead of break it up.
 
Images make an article memorable and attractive. Pictures can speak where words fail. At the same time, misplaced or untidy images can take away from an article. When choosing images, keep in mind placement, size, and the appropriateness of the image to the section. Let images flow with the text instead of break it up.
   
Large images such as screenshots should use the "thumb" (example: <nowiki>[[Image:CoolImage.png|thumb]]</nowiki>) option, which displays images as thumbnails. Images should generally be aligned on the right-hand side of the page to enhance readability by allowing a smooth flow of text down the left margin — the "thumb" option does this by default. If an infobox is not being used in an article, a right-aligned picture in the lead section is encouraged.
+
Large images such as screenshots should use the "thumb" (example: <tt><nowiki>[[Image:CoolImage.png|thumb]]</nowiki></tt>) option, which displays images as thumbnails. Images should generally be aligned on the right-hand side of the page to enhance readability by allowing a smooth flow of text down the left margin — the "thumb" option does this by default. If an infobox is not being used in an article, a right-aligned picture in the lead section is encouraged.
   
 
====Galleries====
 
====Galleries====
When an article has many images, or can be improved by having more, the use of a <nowiki><gallery></nowiki> section is encouraged. Be sure to end it with <nowiki></gallery></nowiki>.
+
When an article has many images, or can be improved by having more, the use of a <tt><nowiki><gallery></nowiki></tt> section is encouraged. Be sure to end it with <tt><nowiki></gallery></nowiki></tt>.
   
 
In the gallery, you can enter captions to emphasize/describe the image.
 
In the gallery, you can enter captions to emphasize/describe the image.
Line 73: Line 91:
   
 
===Quotations===
 
===Quotations===
Similar to images, in-universe quotations can be inserted into a page to provide some additional flavor. To make a quotation, use the <nowiki>{{Quote}}</nowiki> template. In order to make a quotation complete, one must add the text, along with the speaker (name's in '''bold''') and the origin. For example, use <nowiki>{{Quote|Stick around.|'''[[Alan "Dutch" Schaefer|Dutch]]''' (from ({{P1}})}}</nowiki>. This quotation will then appear as:
+
Similar to images, in-universe quotations can be inserted into a page to provide some additional flavor. To make a quotation, use the <tt><nowiki>{{Quote}}</nowiki></tt> template. In order to make a quotation complete, you must add the text, along with the speaker (names in '''bold''') and the origin. For example, use <tt><nowiki>{{Quote|Stick around.|'''[[Alan "Dutch" Schaefer|Dutch]]''' (from ({{P1}})}}</nowiki></tt>. This quotation will then appear as:
   
 
{{Quote|Stick around.|'''[[Alan "Dutch" Schaefer|Dutch]]''' (from {{P1}})}}
 
{{Quote|Stick around.|'''[[Alan "Dutch" Schaefer|Dutch]]''' (from {{P1}})}}
Line 84: Line 102:
 
{{Stub}}
 
{{Stub}}
   
Article message boxes can also be used to propose the deletion, renaming or merging of a page, and should generally be used to promote discussion on the issue before any such alterations are made.
+
Article message boxes can also be used to propose the deletion, renaming or merging of a page, and should generally be used to promote discussion on the issue before any such alterations are made. Some of the most common Xenopedia message boxes can be found on the [[Xenopedia:Templates|templates]] page.
   
 
===Navigation boxes===
 
===Navigation boxes===
Navigation boxes, which are placed at the end of an article, help users to locate pages on similar subjects.
+
Navigation boxes, which are placed at the end of an article, help users to locate pages that cover a similar or related subject. For example:
   
 
{{FilmNavBox}}
 
{{FilmNavBox}}
   
 
===References===
 
===References===
The last section should always be "References". Adding <nowiki><references/></nowiki> under the section header, along with "<nowiki><ref></nowiki>" and "<nowiki></ref></nowiki>" at the relevant points in the article itself, will automatically generate a list of references.
+
The last section on a page should always be "References". Adding <tt><nowiki><references/></nowiki></tt> under the section header, along with "<tt><nowiki><ref></nowiki></tt>" and "<tt><nowiki></ref></nowiki></tt>" at the relevant points in the article itself, will automatically generate a list of references. More information on referencing can be found on our [[Xenopedia:Referencing|referencing]] policy page, while a list of templates that can be used to properly display referenced information can be found in the relevant section of the [[Xenopedia:Templates|templates]] page.
   
 
===Categories===
 
===Categories===
Pages should be added into categories so that similar subjects can be grouped together — a full list of categories can be found on [[Special:Categories]]. Categories can either be added on the page, in the form <nowiki>[[Category:Categoryname]]</nowiki>, or in the "Add category..." box to the right of the editing pane. Before adding categories, please review the [[Xenopedia:Categorization|Categorization Policy]] to avoid inappropriate categories or over-categorization.
+
Pages should be added into categories so that similar subjects can be grouped together — a full list of categories can be found on [[Special:Categories]]. Categories can either be added on the page, in the form <tt><nowiki>[[Category:Categoryname]]</nowiki></tt>, or in the "Add category..." box to the right of the editing pane. Before adding categories, please review the [[Xenopedia:Categorization|categorization]] policy to avoid inappropriate categories or over-categorization.
   
 
All articles should be accessible via subcategories of the top level category, [[:Category:Xenopedia]].
 
All articles should be accessible via subcategories of the top level category, [[:Category:Xenopedia]].
Line 131: Line 149:
 
Real-world articles should be written in either past or present tense as appropriate. For example: {{A2}} '''is''' a film, present tense, because it will always exist. However, it '''was''' filmed at [[Pinewood Studios]], past tense, because it happened in the past.
 
Real-world articles should be written in either past or present tense as appropriate. For example: {{A2}} '''is''' a film, present tense, because it will always exist. However, it '''was''' filmed at [[Pinewood Studios]], past tense, because it happened in the past.
   
 
===Linking===
====In-universe: characters====
 
  +
{{See|Help:Links}}
All in-universe articles should be structured as follows:
 
 
Generally speaking, a subject should be linked once upon its first appearance in the article's infobox (if applicable), once upon its first mention in the article's intro, and once upon its first mention in the article's main body.
#Title/Eras
 
#Infobox
 
#Introduction
 
#Biography/History
 
#Personality and Traits
 
#Equipment
 
#Behind the Scenes
 
#Trivia
 
#Appearances
 
#Gallery
 
#References
 
   
  +
Media listed in an "Appearances" section should also always be linked, regardless of where else it is linked on the page.
For more details as to what each section of an article should contain, see the '''[[Xenopedia:Layout Guide|Layout Guide]]'''. Please note that not all articles use every section.
 
 
====OOU articles on reference works====
 
All out-of-universe articles on books, comics, etc. should generally be structured as follows. This list is typically more flexible than main articles.
 
#Title/Eras/Infobox
 
#Introduction
 
#Stub
 
#Editions
 
#Publisher's summary
 
#Plot summary
 
#Excerpts
 
#Appearances
 
#Behind the scenes
 
#Cover gallery
 
#Succession box
 
#Notes and references
 
#See also
 
#External links
 
#Category
 
#Interwiki links
 
 
==Italics and miscellaneous grammar==
 
===Class and ship names===
 
Names of specific spaceships should be:
 
*Capitalized
 
*Italicized in appropriate instances {{C|See italicization clause below}}
 
*Referred to by neutral pronouns (it, its)
 
 
:e.g.
 
:"The ''Sulaco'' was….r. Its executive officer was Bishop."
 
 
The use of the definite article should follow the most common use for that ship in canonical sources.
 
 
The italicization of a ship's name should follow the most common way the name is presented in canonical sources.
 
 
Class names are italicized only when a spaceship in the class bears the same name. The definite article may be used, but it is not required.
 
*When a ship's class is a modifier, use a hyphen:
 
::"''Conestoga''-class bulk cruiser"
 
*When it is a noun, do not use a hyphen:
 
::"Ships of the Conestoga class were often overlooked"
 
 
:e.g.
 
:A ''Conestoga''-class battleship
 
 
Do not italicize a class name when:
 
*Using the class name and type, but without "-class"
 
*It is being used alone as a noun
 
 
Fighter, missile, and other craft types where a specific spaceship does not bear the class name should be
 
*Capitalized
 
*Un-italicized
 
*Preceded by the full technical designation in the first instance, and may be referred to solely by type name or common name in all succeeding instances.
 
*Referred to with neuter pronouns (it)
 
 
:e.g.
 
 
===Apostrophes and possessives ending in "s"===
 
While plural nouns ending in "s" should be made possessive by adding only an apostrophe, singular nouns ending in "s" can be made possessive by adding either an apostrophe followed by another "s" or simply an apostrophe, providing each article is consistent throughout. Users are encouraged, but not required, to use only an s' for possessive nouns ending in a Z-sound. For example, (example)
 
 
===Xenomorphs and gender===
 
If a [[Xenomorph (Alien)|xenomorph]] is predominantly referred to as "he" or "she" in [[canon]], refer to them as "he" or "she" rather than "it".
 
 
==Linking==
 
A subject should be linked once upon its first appearance in the article's infobox, once upon its first mention in the article's intro, and once upon its first mention in the article's main body.
 
 
   
 
==Conclusion==
 
==Conclusion==
Line 215: Line 159:
   
 
==See Also==
 
==See Also==
*[[Xenopedia:Manual of Style/Sample]] — a sample Xenopedia character article.
+
*[[Xenopedia:Manual of Style/Samples]] — a list of sample Xenopedia articles showing some appropriate layouts.
  +
  +
[[Category:Manual of Style]]

Revision as of 16:42, 16 December 2014

This Manual of Style outlines a standard of clean, consistent formatting for articles on Xenopedia. The formatting described here is a guideline and can be overridden where circumstances warrant it. These guidelines will never be perfect for every situation. However, please keep to the standard format outlined in this article so others may use your edits as an example when creating and editing other articles.

These guidelines are a summary of the most important guidelines for this wiki, but a more expansive set of style guidelines can be found at Wikipedia's Manual of Style. If you are new to wikis, you may also like to read Help:Editing. A list of sample articles based off these guidelines can be found on the samples page.

Below are some basic Alien vs. Predator formatting do's and don't's.

Grammar

Grammar is a writer's toolbox. You can't build good sentences without knowing how to use your tools. Since a wiki article must be as clear as possible for all the people reading it, editors must keep close to correct grammar standards to ensure clear communication.

Capital letters

All film, game, book, comic and character names should be written in title case, where all words are capitalised, except common short words such as "and", "the", "if", "of" or "in". Two short words that notably should be capitalized are "Is" and "It".

Semi-sentient or non-sentient creature names should not start with a capital letter unless dictated otherwise by canon. For example, writing "Rhynth" instead of "rhynth" is agrammatical. As much as we would not capitalize "Dog" or "Cat" in real-life, we should not capitalize fictional creature names. A notable exception to this is the Xenomorph, which is capitalized, as "Xenomorph" is a shortening of "Xenomorph XX121", the creature's full, official name and a proper noun.

Military ranks, such as "corporal" or "private", should start with a capital letter: for example, use "Corporal Hicks", not "corporal Hicks". Ranks or titles aboard a ship should also start with a capital letter when used as a title: for example, use "Captain Dallas", not "captain Dallas". However, when used generically, ship ranks should be in lower case, as in "Dallas was the captain of the ship."

Italics

Italics should always be used for the titles of films, games, books and comics: for example, Predator 2 or Alien: River of Pain.

Ship and class names

Names of specific spacecraft should always be capitalized and should always written in italics; however, any prefix should be written without italics: for example USS Sulaco. Ships should also be referred to using neutral pronouns (i.e. it, its).

The name of a ship class names should also be italicized. When a ship's class is a modifier, it should include a hyphen: "A Conestoga-class transport". When it is a noun, is should not include a hyphen: "A ship of the Conestoga class".

Apostrophes and possessives ending in "s"

While plural nouns ending in "s" should be made possessive by adding only an apostrophe, singular nouns ending in "s" can be made possessive by adding either an apostrophe followed by another "s" or simply an apostrophe, providing each article is consistent throughout.

Xenomorphs and gender

Xenomorphs are predominantly assumed to have no gender and therefore referred to as "it" or "them", with the exception of Queens which are often referred to as feminine. However, if a specific Xenomorph is referred to as "he" or "she" in canon, refer to them as such in their article.

Yautja

The word Yautja has an identical singular and plural, similar to the words "sheep" or "spacecraft". An "s" should not be added when referring to more than one Yautja.

Article Layout

One of the most important parts of wiki editing is knowing how to structure an article. The structure is a powerful thing: it dictates what information the reader reads and when he or she reads it. It can influence what people contribute, where it goes, and how it might be written. Structure has the power to inform or confuse the same way good or bad writing does. Keep a well structured article, and you're more likely to have a high quality one.

Organize sections in an article in a hierarchical structure like you would an outline. Keep it logical, but feel free to forsake strict logic for readability. Wherever necessary, use subsections to break up lengthy blocks of text and make the page easier and more inviting for people to read.

Above all, keep your layout consistent. Don't throw your reader a curve ball too often. Consistency, particularly across different articles, is one of the easiest ways to make a wiki appear more professional; if everything follows a similar pattern, it gives the impression of forward planning and oversight. The example articles listed on the samples page will show you how to create a page that conforms with those already on Xenopedia, particularly with regards to the appropriate sections and headings you should try to include.

The following sections will also offer some good advice on keeping your articles clean, consistent, and clear.

Main page/see also

Some pages may contain a brief summary of information that is elaborated on elsewhere on a dedicated page. To direct the user to the main page, type {{Main|}} and enter the name of the main page itself after the bar, like this — {{Main|Chestburster}}. The result will be:

Main article: Chestburster

Similarly, you may wish to link to an article that contains related information but is not specifically dedicated to the topic at hand. In those instances, use the {{See|}} template exactly as you would above. For example, {{See|Plasma Caster}} will give:

See: Plasma Caster

Table of contents

A table of contents is automatically added to articles that have at least four headings. However, you may wish to insert a table of contents into a longer article that has fewer headings, to make it easier for readers to navigate. You may also wish to remove a table of contents from a page; while this is generally not a good idea, it may be beneficial in some cases. To add or remove a table of contents, type the following at the top of the page, after the opening section:

To add a table of contents: __TOC__
To remove the table of contents: __NOTOC__

Section headings

You can make a section header by typing two "equal" signs, the title of the header, and then two more "equal" signs, for example:

==Example==

To make subsections, use progressively more equal signs. For example:

===Subsection of Example===

Do not use links in subject headings. Instead, consider putting the relevant link in the first or second sentence of the section and linking it there. Alternatively, the main page or see also templates can be placed directly beneath the heading.

Section headings should be capitalized. For example, use "Personality and Traits", not "Personality and traits". Subsection headings should only capitalize the first word and any proper nouns.

Avoid using special characters in headings, such as an ampersand (&), a plus sign (+), curly braces ({}), or square braces ([]). In place of the ampersand, use the word "and", unless the ampersand is part of a formal name.

Always keep headings short and simple. Headings are guidelines to your page's structure and should inform the reader rather than confuse. To keep it short, avoid unnecessary words or redundancy in headings (i.e. avoid a, an and the, pronouns, repeating the article title, and so on). Also, try to avoid giving identical titles to different sections.

Images

See: Help:Images
Example

Caption

Images make an article memorable and attractive. Pictures can speak where words fail. At the same time, misplaced or untidy images can take away from an article. When choosing images, keep in mind placement, size, and the appropriateness of the image to the section. Let images flow with the text instead of break it up.

Large images such as screenshots should use the "thumb" (example: [[Image:CoolImage.png|thumb]]) option, which displays images as thumbnails. Images should generally be aligned on the right-hand side of the page to enhance readability by allowing a smooth flow of text down the left margin — the "thumb" option does this by default. If an infobox is not being used in an article, a right-aligned picture in the lead section is encouraged.

Galleries

When an article has many images, or can be improved by having more, the use of a <gallery> section is encouraged. Be sure to end it with </gallery>.

In the gallery, you can enter captions to emphasize/describe the image.

Quotations

Similar to images, in-universe quotations can be inserted into a page to provide some additional flavor. To make a quotation, use the {{Quote}} template. In order to make a quotation complete, you must add the text, along with the speaker (names in bold) and the origin. For example, use {{Quote|Stick around.|'''[[Alan "Dutch" Schaefer|Dutch]]''' (from ({{P1}})}}. This quotation will then appear as:

"Stick around."
Dutch (from Predator)

Quotations should only be used either at the top of a page, or at the start of a section or subsection. They should also have some relevance to the section/subsection's content.

Message boxes

Article message boxes can be placed at the top of an article to alert editors of a page's status. For example, a short article may contain the following message box:




Article message boxes can also be used to propose the deletion, renaming or merging of a page, and should generally be used to promote discussion on the issue before any such alterations are made. Some of the most common Xenopedia message boxes can be found on the templates page.

Navigation boxes

Navigation boxes, which are placed at the end of an article, help users to locate pages that cover a similar or related subject. For example:

Template:FilmNavBox

References

The last section on a page should always be "References". Adding <references/> under the section header, along with "<ref>" and "</ref>" at the relevant points in the article itself, will automatically generate a list of references. More information on referencing can be found on our referencing policy page, while a list of templates that can be used to properly display referenced information can be found in the relevant section of the templates page.

Categories

Pages should be added into categories so that similar subjects can be grouped together — a full list of categories can be found on Special:Categories. Categories can either be added on the page, in the form [[Category:Categoryname]], or in the "Add category..." box to the right of the editing pane. Before adding categories, please review the categorization policy to avoid inappropriate categories or over-categorization.

All articles should be accessible via subcategories of the top level category, Category:Xenopedia.

Writing

"I believe the road to hell is paved with adverbs."
Stephen King

We now come to the meat of an article: the words themselves. When you're editing wikis, you're both academic and artist. You have to be accurate, but you also have to be interesting. Neither one can dominate; you have to skillfully balance both.

Keep your writing concise. Don't use two words where one will do. Keeping your writing simple will make it easy to understand and easy to expand on. Use complete sentences whenever possible. When you write, use grammar as a toolbox: know the rules, but only break them on purpose.

Check your spelling and grammar. Do not use abbreviations, such as "u" in place of "you" or "2" in place of "to". It is also generally best to avoid contractions such as "don't" and "can't"; instead, write "do not" or "cannot" (an obvious exception to this is in quotations, where applicable). Write the way you would for a class paper or a newspaper article.

Keep all of the topics you cover within the scope of the article. You don't need to give a detailed history of the United States Colonial Marine Corps on the page about an individual Colonial Marine. Consider the article's title as your point of origin and write from that perspective. Make use of the wiki's ability to link to more detailed articles or external sources for more information.

Be bold. If you know something is wrong, correct it. If you can word something better, alter it. If an article has a glaring deficiency, fill it. Even if your first attempt isn't golden, either you or someone else can fix it later. Don't be afraid to screw up.

Know the rules. Reading existing pages is a good way to get a general sense of the wiki's style, but Xenopedia is a work in progress — not all existing pages follow the rules or are up to scratch... yet. Be sure to review the wiki's rules. The main Policy page contains a list of Xenopedia's policy articles.

Perspective

Articles on Xenopedia are written from one of two main perspectives: in-universe or real-world.

  • In-universe perspective is written as though the author exists within the Alien vs. Predator universe, and is describing the events or people of the that universe as if they were real. Any real-world context is ignored. An in-universe perspective is used for the majority of the articles on Xenopedia. However, it is not uncommon for in-universe articles to have a "Behind the Scenes" section that is written from a real-world perspective.
  • Real-world perspective is written from a real-life point of view. This is chiefly reserved for pages referring to real-life films, games, publications, toys, actors and authors. Real-world articles will specifically acknowledge that the Alien vs. Predator universe they are describing is an entirely fictional one.

Spelling

Though the readers and editors of Xenopedia speak many varieties of English, we mandate standard American English spelling, grammar, punctuation and word usage. This is the variety of English used in the first printings of most primary sources.

If a source's title is in British English, it must not be converted into American English. Also, if a direct quotation from a British source has a word which is spelled differently in American English, the original British spelling must be preserved. However, a [sic] sign may be put after the word.

Tense

All in-universe articles should be written in past tense. The articles on Xenopedia are presented as historical recordings that have been pieced together from scraps of information left over from the Alien vs. Predator era. As such, all details pertaining to this history have not yet been uncovered, and more information may be added at a later date. Keeping articles written in past tense provides consistency and flavor.

Real-world articles should be written in either past or present tense as appropriate. For example: Aliens is a film, present tense, because it will always exist. However, it was filmed at Pinewood Studios, past tense, because it happened in the past.

Linking

See: Help:Links

Generally speaking, a subject should be linked once upon its first appearance in the article's infobox (if applicable), once upon its first mention in the article's intro, and once upon its first mention in the article's main body.

Media listed in an "Appearances" section should also always be linked, regardless of where else it is linked on the page.

Conclusion

Every article can be improved (even this one). Following these guidelines will not ensure a perfect article the first time, but it will give the article a stronger skeleton. It is ultimately your job as an editor, along with other Xenopedia uses, to put the meat on it.

See Also