Editing BattleTechWiki:Manual of Style/References

As it is the goal of BattleTechWiki to enable each Reader to find the original source for any fact found within an article, the proper citation of sources is critical. This page explains how to create '''numbered references''' (with optional footnotes) using <code><nowiki><ref></nowiki></code>,<code><nowiki></ref></nowiki></code>, and <code><nowiki><references/></nowiki></code> syntax, which is the current best-practice method in most circumstances. 

==Overview==
===Inserting references or footnotes===
Readers and Editors of BattleTechWiki will find articles in one of three general states when it comes to being properly referenced: non-cited, basic, and detailed. It is the ultimate intention for each article on the wiki to exist within a consistent framework in comparison to other similar articles, with detailed references displayed at the bottom of the page, as warranted for proper research sources. However, as BTW is completely a [[Special:UserScore|volunteer]] effort, the time, skill and details provided by each Editor will vary. It is the intention that follow-on Editors will continue to improve the article, including the method of sourcing the article's statements.

===Non-cited References===
Non-cited articles can, aside from the lack of references, vary considerably in value when compared to other non-cited articles, from being a stub-length to fully-scoped out with considerable detail. However, no Editors will have spared the time to indicate where the information found in the non-cited article can be located in [[Policy:Canon|canon]] and there will not be a References section provided. This article may or may not be of any value to a casual Reader, but it will most definitely not be worth much to a Reader seeking official confirmation for a question they might have about the BattleTech universe, especially if they doubt the value BattleTechWiki has to canonicity.

Once identified as lacking in citations, follow-on Editors will often (and justly so) add the '''<nowiki>{{refimprove}}</nowiki>''' tag, where the resulting banner indicates the article is lacking sufficient citations.

==Basic References (Bibliography)==
This article will, thankfully, include at least some sources indicating where the interested Reader may go to get either more information or confirmation of the article's sources. However, as it only lists the titles of the sources, it is left up to the Reader to look through the source until he finds the relevant information. Still, it is better than nothing and the Editors at BTW implore their fellows to provide at least this much. Entries should be alphabetical.

The format for Basic citing is:
* A section called Bibliography is made. It can be created by placing the following code at the bottom of the page (above the Category tags):
  ==Bibliography==
* Underneath that, an asterisk (*) is placed for each title
* The source is then listed next to the asterisk:
:#First, following a space, two single quotes (<nowiki>''</nowiki>) are typed, 
:#followed by two open brackets ([[),
:#then the title of the source (in the manner consistent with its BTW article name),
:#followed up by two close brackets (]]) and
:#then two more single quotes (<nowiki>''</nowiki>).
So, if you were to cite the two books ''[[Dominions Divided]]'' and ''[[AeroTech 2]]'' by typing this:
    <nowiki>* ''[[AeroTech 2]]''</nowiki>
    <nowiki>* ''[[Dominions Divided]]''</nowiki>
When saved, it would look like this:
{|class=wikitable
|
* ''[[AeroTech 2]]''
* ''[[Dominions Divided]]''
|}
* If the BTW article page being referenced has parentheses, it is because there was another similarly named article. Because this disambiguation is not actually part of the source title, it is preferred to hide or separate it from the list using the vertical bar (|).
So, if you were to cite the following sources ''[[FedCom Civil War (sourcebook)]]'', ''[[Luthien (scenario pack)]]'', ''[[Exodus Road (novel)]]'', and ''[[BattleTech (Video Game)]]'' by typing this:
    <nowiki>* ''[[BattleTech (Video Game)|BattleTech]]'' (video game)</nowiki>
    <nowiki>* ''[[FedCom Civil War (sourcebook)|FedCom Civil War]]''</nowiki>
    <nowiki>* ''[[Luthien (scenario pack)|Luthien]]''</nowiki>
    <nowiki>* ''[[Mercenary's Star (novel)|Mercenary's Star]]'' (novel)</nowiki>

When saved, it would look like this:
{|class=wikitable
|
* ''[[BattleTech (Video Game)|BattleTech]]'' (video game)
* ''[[FedCom Civil War (sourcebook)|FedCom Civil War]]''
* ''[[Luthien (scenario pack)|Luthien]]''
* ''[[Mercenary's Star (novel)|Mercenary's Star]]'' (novel)
|}
Note that sourcebooks and scenario packs are so commonplace in bibliographies that Editors are allowed to omit the parentheticals after the link.

==Detailed References==
The [[BattleTechWiki:The perfect article|perfect article]] would include detailed references. The more detail an Editor can provide an article, the more value that article has to readers and other Editors later on. While citing at least the title source used within an article is appreciated, providing a bit more detail offers so much more to the article and the BattleTechWiki project. Here, the Editor not only provides the title but he narrows down the source search considerably by offering more information to those that follow, with a minimum of page numbers comprising the information found in the article.

The format for a specified reference is title, followed by the page(s), and source section name. For example:

{|class=wikitable
|
* ''FedCom Civil War'', p. 104: "Operation Scatter"
* ''AeroTech 2'', pp. 35–37: "Strafing"
|}

A solitary 'p' followed by a period is used if just a single page is used in the citation. If the relevant data spans several pages, it is indicated by a double 'p'. Use an en-dash (–) when indicating ranges of consecutive pages. Providing the section title from the source between two double quotes ("), while not required, is helpful in instances where readers might have difficulty finding the material for reasons such as mislabeled page numbers, inconsistent page numbering between print and digital editions, or even due to dense information or writing on the page.

Is not uncommon for page numbers to be missing from stories formatted for E-readers. In that case, Editors should provide the chapter(s) numbers. For example:

{|class=wikitable
|
* ''The Damocles Sanction'', ch. 8
* ''Wolf Pack'', chs. 32–35
|}

When source material is scattered throughout one book, it is preferred that the Editor create separate citations for each relevant source section. But, the Editor also has the choice of simply listing the various pages (without the section titles), or combining both together (separated by semi-colons), as show below:

{|class=wikitable
|
* ''FedCom Civil War'', pp. 104, 120–121, 133
* ''AeroTech 2'', pp. 35–37: "Strafing"; p. 107: "Combat Drops"; pp. 116–117: "Basic Jump Procedure"
|}

An Editor may also make use of the reference to provide some details that would not be appropriate within the article itself, as a footnote after a colon (:), following the actual citation. For example:

{|class=wikitable
|
* ''FedCom Civil War'', pp. 104, 120–121, 133: the book suggests it was actually Peter, not Victor, that made this statement, as indicated on p. 133; this editor presumes it was just an editorial mistake, as Peter was in a coma at that specific point in time.
* ''AeroTech 2'', pp. 35–37: "Strafing"; p. 107: "Combat Drops"; pp. 116–117: "Basic Jump Procedure": this book says passengers are more likely to see [http://en.wikipedia.org/wiki/Lucky_Charms green clovers] and blue diamonds while jumping thru hyperspace, while the original ''[[AeroTech]]'' was clear that they would only have seen pink hearts and purple horseshoes.
|}

The purpose of adding details is to offer information for something not obvious in the source itself. The Editor does not need to mention that a character profile has the year of birth listed; on the other hand, if the profile provides the character's age without giving the birth year, noting the in-universe year of the sourcebook as an explanation for how the birth year was determined would be appropriate.

===Formatting===
Detailed references get listed in a section at the bottom of the page above the Bibliography. To enable citations, use the following code:
  ==References==
  <nowiki><references /></nowiki>

Detailed referencing gets into the "guts" of the article in order to provide the most comprehensive source citing possible. If the data from a complete paragraph can be found on one page (or one range of pages) from a single source, the reference is generally added to the end of the paragraph. However, if the paragraph combines facts compiled from multiple pages or sources, the citations may be found within the paragraph itself, generally following a sentence (though sometimes within sentences, when clarity is most valued). The [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] software BattleTechWiki utilizes is very capable at providing the depth necessary for this in-depth citation work. 

Using the format for detailed references [[Help:References#Detailed References|learned above]], we'll use that to cite the following example:

{|class=wikitable
|
The first project of the congress to be published was the ''Unfinished Book'', a ten-volume collection of scripture from numerous religions, released in 2959. It received its name from the concept that spiritual wisdom was extremely vast and therefore the project would take an undetermined amount of time to accumulate it in totality. Father Ovidon held the belief that if the project could be completed, then all of humanity would enjoy peaceful coexistence, either from divine intervention or possibly from the intellectual elevation of mankind.
|}

In this case, the two books ''[[House Davion (The Federated Suns)]]'' and ''[[Handbook: House Davion]]'' are used for this paragraph. Because the first sentence uses data from both books, the Editor wants to cite both of them following the sentence. He takes the relevant citations:
{|class=wikitable
|
''House Davion (The Federated Suns)'', p. 117: "Unfinished Book Movement"<br>
''Handbook: House Davion'', pp. 146–147: "Unfinished Book Movement"
|}

...and wraps each one in-between the following codes: <nowiki><ref name="ReferenceName"></nowiki> & <nowiki></ref></nowiki>, so that it looks like the following when typed into the edit box:

     <nowiki><ref name=HD(TFS)p117>''House Davion (The Federated Suns)'', p. 117: "Unfinished Book Movement"</ref></nowiki>
     <nowiki><ref name=H:HSp146-147>''Handbook: House Davion'', pp. 146–147: "Unfinished Book Movement"</ref></nowiki>

The two references will be snugged up against each other, unbroken by a space or line return. This is so the citation numbers the wiki creates follow directly after the sentence it pertains to, without breaking up the flow of the text. In this case, the rest of the paragraph comes from only the first source, so the Editor inserts the code for the first source at the end of the paragraph also, but this time in an abbreviated form:

    <nowiki><ref name=HD(TFS)p117/></nowiki>

The unsaved paragraph would look like this:

{|class=wikitable
|
The first project of the congress to be published was the Unfinished Book, a ten-volume collection of scripture from numerous religions, released in 2959.<nowiki><ref name=HD(TFS)p117>''House Davion (The Federated Suns)'', p. 117: "Unfinished Book Movement"</ref><ref name=H:HSp146-147>''Handbook: House Davion'', pp. 146–147: "Unfinished Book Movement"</ref></nowiki> It received its name from the concept that spiritual wisdom was extremely vast and therefore the project would take an undetermined amount of time to accumulate it in totality. Father Ovidon held the belief that if the project could be completed, then all of humanity would enjoy peaceful coexistence, either from divine intervention or possibly from the intellectual elevation of mankind.<nowiki><ref name=HD(TFS)p117/></nowiki>
|}

Very cluttered and confusing, isn't it? However, the results are worth it, as the saved paragraph would look like this:

{|class=wikitable
|
The first project of the congress to be published was the Unfinished Book, a ten-volume collection of scripture from numerous religions, released in 2959.<ref name=HD(TFS)p117>''House Davion (The Federated Suns)'', p. 117: "Unfinished Book Movement"</ref><ref name=H:HSp146-147>''Handbook: House Davion'', pp. 146–147: "Unfinished Book Movement"</ref> It received its name from the concept that spiritual wisdom was extremely vast and therefore the project would take an undetermined amount of time to accumulate it in totality. Father Ovidon held the belief that if the project could be completed, then all of humanity would enjoy peaceful coexistence, either from divine intervention or possibly from the intellectual elevation of mankind.<ref name=HD(TFS)p117/>
|}

The three blue numbers would then, when clicked upon, shift the browser page down to the References section of the article, right to the specific reference with which it is associated. So, once the page is saved it would appear thusly:

{|class=wikitable
|
<u>References</u>
<references />
|}

Rather snazzy, no? Notice, how the first and last citations from the same source are shown on the same line. This gives it a cleaner look compared to having a separate line for each instance. This is sometimes referred to as citation consolidation. To view this example in its full article context, [[Unfinished Book Movement#References|click here]].

The Editor will have to take note, however, that each individual citation will require its own name even if it shares the same title source. Initially this may cause some confusion, especially in lengthier articles where one source may provide numerous but differing pages of data for the article. For example:

     <nowiki><ref name=H:HSp145a>''Handbook: House Davion'', p. 145: "Hinduism"</ref></nowiki>
     <nowiki><ref name=H:HSp145b>''Handbook: House Davion'', p. 145: "Islam"</ref></nowiki>
     <nowiki><ref name=H:HSp146>''Handbook: House Davion'', p. 146: "Judaism"</ref></nowiki>

Here, the Editor chose to differentiate the first two sources with 'a' and 'b' in the reference name, but you are free to pick any name, subject to a few rules. They are case sensitive and may not be a numeric integer. The quotes are optional unless the name or group includes a space, punctuation or other mark. Names and groups should be kept simple and restricted to the standard English alphabet and numerals. The reference name is internal and will not be displayed anywhere when the page is viewed.  

Ideally, the full, written-out reference should be used in its first appearance in the text, followed by the abbreviated ones. While it's understandable that it might feel a bit "crowded" at the top of the page where many different sources are being introduced together, this practice makes it easier for all Editors to find source information more quickly.

===Simplified method===
Though not preferred, Editors having difficulty formatting detailed citations can used a simplified version as a placeholder until a later time in which it can be sorted out and updated. Rather than requiring a reference name, the Editor need only use <nowiki><ref></nowiki> & <nowiki></ref></nowiki> as such:

     <nowiki><ref>''Handbook: House Davion'', p. 145: "Hinduism"</ref></nowiki>
     <nowiki><ref>''Handbook: House Davion'', p. 145: "Islam"</ref></nowiki>
     <nowiki><ref>''Handbook: House Davion'', p. 146: "Judaism"</ref></nowiki>

This method, however, does not allow for consolidation and each citation will create a new line in the References section, even if they are copied and pasted throughout the article.

==Note regarding Reference and Bibliography sections==
Basic and Detailed referencing utilize the References and Bibliography sections in tandem. The Basic method, when not mixed in with more advanced citing within an article, makes use of the Bibliography section ''without'' a References section. However, once more advanced citing is introduced within an article, both sections should be included and references are handled in a rather different manner.

===Reference section===
With the use of Detailed citations, the References section serves a means to indicate ''where'' certain information provided within the article can be found ''in'' official sources. In that case, it is no longer appropriate to include title-only entries (''ex:'' <nowiki>''[[FedCom Civil War]]''</nowiki>) in the References section. Instead, these should be added to the following Bibliography section. A reasonable exception might be made for short stories that don't have page numbers or chapters, especially those accessed by an E-reader.

===Bibliography section===
Once a Bibliography section is added to an article, the article should also have a functional References section. The Bibliography section provides a quick means of identifying official (and, rarely, unofficial) sources of material that coincide with the article. For clarity's sake, entries should be in alphabetical order, by series title and then specific titles within it — ''e.g.'' ''Field Report: Fluffy Bunny Kingdom'' should precede ''Field Report 2765: Centrifugal Bumble-Puppy Thunderdominion''.

It should be clear, however, that the inclusion of a source's title within the Bibliography section ''does not'' necessarily indicate that source has been used yet (or will at all) within the above article. Oftentimes, Editors may recognize that a source exists that also provides information on the subject of the article, but has not been included within the article itself. This identifies for Readers the additional source they can use to learn more about the subject and allows follow-on Editors to identify additional sources to utilize in expanding the article. By providing the linked title within the Bibliography section, it allows both Readers and Editors to go the BTW article about that source. 

Additionally, the Bibliography section should not simply be a recitation of the sources listed in the References section. If a source cited in the article does not address the subject of the article, it does not warrant inclusion in the Bibliography section.

For example, in an article about the [[10th Army (Star League)|10th Star League Army]], a quote describing the unit's invasion target, [[Acamar]], as "a constant winter wonderland" is cited as coming from a page about Acamar in the sourcebook ''[[Dark Age: Republic Worlds (3130)]]''. The citation will be listed in the References section, but the sourcebook should not be listed in the Bibliography section{{m}}because it does not address the article's subject, the Tenth Army.


[[Category:Help|{{PAGENAME}}]][[Category:Manual of Style]]