Jump to content

Draft:Manual of Style: Difference between revisions

From BattleIntelligence
imported>Deadfire
 
m Text replacement - "BattleTechWiki" to "BattleIntelligence"
 
Line 3: Line 3:
{{Style|expanded=all}}
{{Style|expanded=all}}


This '''Manual of Style''' ('''MoS''' or '''MOS''') is the [[w:style manual|style manual]] for all BattleTechWiki [[BattleTechWiki:What is an article?|articles]] (though provisions related to accessibility apply across the entire project, not just to articles). This primary page is supported by further [[:Category:Manual of Style|detail pages]]. If any contradiction arises, this page has precedence.
This '''Manual of Style''' ('''MoS''' or '''MOS''') is the [[w:style manual|style manual]] for all BattleIntelligence [[BattleIntelligence:What is an article?|articles]] (though provisions related to accessibility apply across the entire project, not just to articles). This primary page is supported by further [[:Category:Manual of Style|detail pages]]. If any contradiction arises, this page has precedence.


{{Anchor|Clarity}}Editors should write articles using straightforward, succinct, easily understood language and structure articles with consistent, reader-friendly layouts and formatting (which are detailed in this guide).
{{Anchor|Clarity}}Editors should write articles using straightforward, succinct, easily understood language and structure articles with consistent, reader-friendly layouts and formatting (which are detailed in this guide).


{{Anchor|Stability}}Where more than one style or format is acceptable under the MoS, one should be used consistently within an article and [[#Retaining existing styles|should not be changed]] without good reason. [[BattleTechWiki:Edit warring|Edit warring]] over stylistic choices is unacceptable.
{{Anchor|Stability}}Where more than one style or format is acceptable under the MoS, one should be used consistently within an article and [[#Retaining existing styles|should not be changed]] without good reason. [[BattleIntelligence:Edit warring|Edit warring]] over stylistic choices is unacceptable.


New content added to this page should directly address a persistently recurring style issue.
New content added to this page should directly address a persistently recurring style issue.
Line 15: Line 15:
==Retaining existing styles==
==Retaining existing styles==
{{Shortcut|MOS:VAR|MOS:STYLEVAR|MOS:STYLERET}}
{{Shortcut|MOS:VAR|MOS:STYLEVAR|MOS:STYLERET}}
Sometimes the MoS provides more than one acceptable style or gives no specific guidance. The principle that "When either of two styles is acceptable it is inappropriate for a BattleTechWiki editor to change from one style to another unless there is some substantial reason for the change."
Sometimes the MoS provides more than one acceptable style or gives no specific guidance. The principle that "When either of two styles is acceptable it is inappropriate for a BattleIntelligence editor to change from one style to another unless there is some substantial reason for the change."


Edit-warring over style, or enforcing optional style in a robot-like fashion without prior consensus, [[BattleTechWiki:Disruptive editing|is never acceptable]].
Edit-warring over style, or enforcing optional style in a robot-like fashion without prior consensus, [[BattleIntelligence:Disruptive editing|is never acceptable]].


Unjustified changes from one acceptable, [[#Consistency within articles|consistently-applied]] style in an article to a different style may generally be [[BattleTechWiki:Reverting|reverted]]. Seek [[BattleTechWiki:Manual of Style#Opportunities for commonality|opportunities for commonality]] to avoid disputes over style.
Unjustified changes from one acceptable, [[#Consistency within articles|consistently-applied]] style in an article to a different style may generally be [[BattleIntelligence:Reverting|reverted]]. Seek [[BattleIntelligence:Manual of Style#Opportunities for commonality|opportunities for commonality]] to avoid disputes over style.


If you believe an alternative style would be more appropriate for a particular article, seek [[BattleTechWiki:Consensus|consensus]] by discussing this at the article's talk page or{{snd}}if it raises an issue of more general application or with the MoS itself{{snd}}at [[BattleTechWiki talk:Manual of Style]]. If a discussion does not result in consensus for the change at the article, continue to use the already-established style there. If discussion fails to reach a consensus regarding which of two or more competing styles to use at all, then default to the style that was used in the first post-[[BattleTechWiki:Stub|stub]] version of the article in which one of the applicable styles appeared. (This fall-back position does not give unchallengable primacy to that particular style during consensus discussion, nor give the editor who imposed that earliest style [[BattleTechWiki:Ownership of content|any more say]] in the discussion.)
If you believe an alternative style would be more appropriate for a particular article, seek [[BattleIntelligence:Consensus|consensus]] by discussing this at the article's talk page or{{snd}}if it raises an issue of more general application or with the MoS itself{{snd}}at [[BattleIntelligence talk:Manual of Style]]. If a discussion does not result in consensus for the change at the article, continue to use the already-established style there. If discussion fails to reach a consensus regarding which of two or more competing styles to use at all, then default to the style that was used in the first post-[[BattleIntelligence:Stub|stub]] version of the article in which one of the applicable styles appeared. (This fall-back position does not give unchallengable primacy to that particular style during consensus discussion, nor give the editor who imposed that earliest style [[BattleIntelligence:Ownership of content|any more say]] in the discussion.)


{{Crossref|For retention of an article's established national variety of English (and potential reasons to change it), see {{section link||National varieties of English}}.}}
{{Crossref|For retention of an article's established national variety of English (and potential reasons to change it), see {{section link||National varieties of English}}.}}
Line 29: Line 29:


===Article titles===
===Article titles===
{{Main|BattleTechWiki:Article titles}}
{{Main|BattleIntelligence:Article titles}}


A title should be a recognizable name or description of the topic, [[BattleTechWiki:Common sense|balancing]] the criteria of being natural, sufficiently precise, concise, and consistent with those of related articles.
A title should be a recognizable name or description of the topic, [[BattleIntelligence:Common sense|balancing]] the criteria of being natural, sufficiently precise, concise, and consistent with those of related articles.


For formatting guidance see the {{section link|BattleTechWiki:Article titles|Article title format}} section, noting the following:
For formatting guidance see the {{section link|BattleIntelligence:Article titles|Article title format}} section, noting the following:
*Capitalize the initial letter (except in rare cases, such as {{xt|eBay}}), but otherwise follow [[sentence case]] ({{xt|Funding of UNESCO projects}}), not title case ({{!xt|Funding of UNESCO Projects}}), except where title case would be expected were the title to occur in ordinary prose. See [[BattleTechWiki:Naming conventions (capitalization)]].
*Capitalize the initial letter (except in rare cases, such as {{xt|eBay}}), but otherwise follow [[sentence case]] ({{xt|Funding of UNESCO projects}}), not title case ({{!xt|Funding of UNESCO Projects}}), except where title case would be expected were the title to occur in ordinary prose. See [[BattleIntelligence:Naming conventions (capitalization)]].
*To italicize, add {{tlx|italic title}} near the top of the article. For mixed situations, use, e.g., <code><nowiki>{{DISPLAYTITLE:</nowiki>{{zwsp}}<nowiki>Interpretations of ''2001: A Space Odyssey''}}</nowiki></code>, instead. Use of italics should conform to {{section link|BattleTechWiki:Manual of Style/Text formatting|Italic type}}.
*To italicize, add {{tlx|italic title}} near the top of the article. For mixed situations, use, e.g., <code><nowiki>{{DISPLAYTITLE:</nowiki>{{zwsp}}<nowiki>Interpretations of ''2001: A Space Odyssey''}}</nowiki></code>, instead. Use of italics should conform to {{section link|BattleIntelligence:Manual of Style/Text formatting|Italic type}}.
*Do not use [[Article (grammar)|articles]] (''a'', ''an'', or ''the'') as the first word ({{xt|Economy of the Second Empire}}, not {{!xt|The economy of the Second Empire}}), unless it is an inseparable part of a name ({{xt|The Hague}}) or title of a work (''{{xt|A Clockwork Orange}}'', ''{{xt|The Simpsons}}'').
*Do not use [[Article (grammar)|articles]] (''a'', ''an'', or ''the'') as the first word ({{xt|Economy of the Second Empire}}, not {{!xt|The economy of the Second Empire}}), unless it is an inseparable part of a name ({{xt|The Hague}}) or title of a work (''{{xt|A Clockwork Orange}}'', ''{{xt|The Simpsons}}'').
*Normally use [[noun]]s or [[noun phrase]]s: {{xt|Early life}}, not {{!xt|In early life}}.
*Normally use [[noun]]s or [[noun phrase]]s: {{xt|Early life}}, not {{!xt|In early life}}.
*The final character should not be punctuation unless it is an inseparable part of a name ({{xt|[[Saint-Louis-du-Ha! Ha!]]}}, {{xt|''[[Do Androids Dream of Electric Sheep?]]''}}) or an abbreviation ({{xt|[[Inverness City F.C.]]}}), or when a closing round bracket or quotation mark is required ({{xt|[[John Palmer (1814 schooner)|''John Palmer'' (1814 schooner)]]}}).
*The final character should not be punctuation unless it is an inseparable part of a name ({{xt|[[Saint-Louis-du-Ha! Ha!]]}}, {{xt|''[[Do Androids Dream of Electric Sheep?]]''}}) or an abbreviation ({{xt|[[Inverness City F.C.]]}}), or when a closing round bracket or quotation mark is required ({{xt|[[John Palmer (1814 schooner)|''John Palmer'' (1814 schooner)]]}}).
*Whenever quotation marks or apostrophes appear, add a [[BattleTechWiki:Redirect|redirect]] for the same title using apostrophes.
*Whenever quotation marks or apostrophes appear, add a [[BattleIntelligence:Redirect|redirect]] for the same title using apostrophes.


Subject both to the above and to [[BattleTechWiki:Article titles]], the rest of the MoS, particularly {{section link||Punctuation}}, applies also to the title.
Subject both to the above and to [[BattleIntelligence:Article titles]], the rest of the MoS, particularly {{section link||Punctuation}}, applies also to the title.


{{crossref|See also [[BattleTechWiki:Manual of Style/Titles of works]], for cases where an article about a published work has a title that coincides with the work's title.}}
{{crossref|See also [[BattleIntelligence:Manual of Style/Titles of works]], for cases where an article about a published work has a title that coincides with the work's title.}}


===Section organization===
===Section organization===
{{Shortcut|MOS:SO}}
{{Shortcut|MOS:SO}}
{{Main|BattleTechWiki:Manual of Style/Layout}}
{{Main|BattleIntelligence:Manual of Style/Layout}}


An article's content should begin with an introductory {{em|lead<!-- Do not add the word "lede" here. See footnotes at BTW:LEAD for details. --> section}}{{snd}}a concise summary of the article{{snd}}which is never divided into sections {{crossref|(see [[BattleTechWiki:Manual of Style/Lead section]])}}. The remainder of the article is typically divided into [[Help:Section|sections]].
An article's content should begin with an introductory {{em|lead<!-- Do not add the word "lede" here. See footnotes at BTW:LEAD for details. --> section}}{{snd}}a concise summary of the article{{snd}}which is never divided into sections {{crossref|(see [[BattleIntelligence:Manual of Style/Lead section]])}}. The remainder of the article is typically divided into [[Help:Section|sections]].


[[BattleTechWiki:Manual of Style/Infoboxes|Infoboxes]], images, and related content in the lead section must be right-aligned.
[[BattleIntelligence:Manual of Style/Infoboxes|Infoboxes]], images, and related content in the lead section must be right-aligned.


Certain standardized [[Help:Template|templates]] and [[Help:Wikitext|wikicode]] that are not sections go at the very top of the article, before the content of the lead section, and in the following order:
Certain standardized [[Help:Template|templates]] and [[Help:Wikitext|wikicode]] that are not sections go at the very top of the article, before the content of the lead section, and in the following order:
*A [[BattleTechWiki:Short description|short description]], with the {{tlx|Short description}} template
*A [[BattleIntelligence:Short description|short description]], with the {{tlx|Short description}} template
*A [[BattleTechWiki:Hatnote|disambiguation hatnote]], most of the time with the {{tlx|Hatnote}} template {{crossref|(see also {{section link|BattleTechWiki:Hatnote#Hatnote templates}})}}
*A [[BattleIntelligence:Hatnote|disambiguation hatnote]], most of the time with the {{tlx|Hatnote}} template {{crossref|(see also {{section link|BattleIntelligence:Hatnote#Hatnote templates}})}}
*No-output templates that indicate the article's established date format and English-language variety, if any (e.g., {{tlx|Use dmy dates}}, {{tlx|Use Canadian English}})
*No-output templates that indicate the article's established date format and English-language variety, if any (e.g., {{tlx|Use dmy dates}}, {{tlx|Use Canadian English}})
*Banner-type maintenance templates, [[BattleTechWiki:Template index/Disputes|Dispute]] and [[BattleTechWiki:Template index/Cleanup|Cleanup templates]] for article-wide issues that have been flagged (otherwise used at the top of a specific section, after any sectional hatnote such as {{tlx|main}})
*Banner-type maintenance templates, [[BattleIntelligence:Template index/Disputes|Dispute]] and [[BattleIntelligence:Template index/Cleanup|Cleanup templates]] for article-wide issues that have been flagged (otherwise used at the top of a specific section, after any sectional hatnote such as {{tlx|main}})
*An [[BattleTechWiki:Manual of Style/Infoboxes|infobox]], which is optional (except in special cases like {{tlx|Taxobox}} and {{tlx|Chembox}}, or a variant thereof, at applicable articles); usually also includes the first image
*An [[BattleIntelligence:Manual of Style/Infoboxes|infobox]], which is optional (except in special cases like {{tlx|Taxobox}} and {{tlx|Chembox}}, or a variant thereof, at applicable articles); usually also includes the first image
*An introductory image, when an infobox is not used, or an additional image is desired for the lead section (for unusually long leads, a second image can be placed midway through the lead text)
*An introductory image, when an infobox is not used, or an additional image is desired for the lead section (for unusually long leads, a second image can be placed midway through the lead text)


If an article has at least four section headings, a navigable [[BattleTechWiki:Table of contents|table of contents]] appears automatically, just after the lead.
If an article has at least four section headings, a navigable [[BattleIntelligence:Table of contents|table of contents]] appears automatically, just after the lead.


If the topic of a section is covered in more detail in a dedicated article {{cross reference|(see [[BattleTechWiki:Summary style]])}}, insert {{tlx|main|{{var|Article name}}}} or {{tlx|further|{{var|Article name}}}} immediately under the section heading.
If the topic of a section is covered in more detail in a dedicated article {{cross reference|(see [[BattleIntelligence:Summary style]])}}, insert {{tlx|main|{{var|Article name}}}} or {{tlx|further|{{var|Article name}}}} immediately under the section heading.


As explained in detail in {{slink|BattleTechWiki:Manual of Style/Layout|Standard appendices and footers}}, several kinds of material (mostly optional) may appear after the main body of the article, in the following order:
As explained in detail in {{slink|BattleIntelligence:Manual of Style/Layout|Standard appendices and footers}}, several kinds of material (mostly optional) may appear after the main body of the article, in the following order:
*Books or other works created by the subject of the article, under a section heading "Works", "Publications", "Discography", "Filmography", etc. as appropriate (avoid "Bibliography", confusable with reference citations)
*Books or other works created by the subject of the article, under a section heading "Works", "Publications", "Discography", "Filmography", etc. as appropriate (avoid "Bibliography", confusable with reference citations)
*Internal links to related English BattleTechWiki articles, with section heading "See also"
*Internal links to related English BattleIntelligence articles, with section heading "See also"
*Notes and references, with a section heading "Notes" or "References" (usually the latter), or a separate section for each in this order {{crossref|(see [[BattleTechWiki:Citing sources]])}}; avoid "Bibliography", confusable with the subject's works
*Notes and references, with a section heading "Notes" or "References" (usually the latter), or a separate section for each in this order {{crossref|(see [[BattleIntelligence:Citing sources]])}}; avoid "Bibliography", confusable with the subject's works
*Relevant books, articles, or other publications that have not been used as sources; use the section heading "Further reading"; be highly selective, as [[BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not a directory|BattleTechWiki is not a bibliographic directory]]
*Relevant books, articles, or other publications that have not been used as sources; use the section heading "Further reading"; be highly selective, as [[BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not a directory|BattleIntelligence is not a bibliographic directory]]
*Relevant [[BattleTechWiki:External links|and appropriate]] websites that have not been used as sources and do not appear in the earlier appendices, using the heading "External links", which may be made a subsection of "Further reading" (or such links can be integrated directly into the "Further reading" list instead); [[BattleTechWiki:Manual of Style/Layout#Links to sister projects|link templates for sister-project content]] also usually go at the top of this section when it is present (otherwise in the last section on the page)
*Relevant [[BattleIntelligence:External links|and appropriate]] websites that have not been used as sources and do not appear in the earlier appendices, using the heading "External links", which may be made a subsection of "Further reading" (or such links can be integrated directly into the "Further reading" list instead); [[BattleIntelligence:Manual of Style/Layout#Links to sister projects|link templates for sister-project content]] also usually go at the top of this section when it is present (otherwise in the last section on the page)
*The following final items never take section headings:
*The following final items never take section headings:
**Internal links organized into [[BattleTechWiki:Categories,_lists,_and_navigation_templates#Navigation_templates|navigational boxes]]
**Internal links organized into [[BattleIntelligence:Categories,_lists,_and_navigation_templates#Navigation_templates|navigational boxes]]
**[[BattleTechWiki:Stub sorting|Stub templates]], if needed
**[[BattleIntelligence:Stub sorting|Stub templates]], if needed
**[[BattleTechWiki:Authority control|Authority control]] metadata, if needed, using {{tlx|Authority control}} (distinguishes uses of the same name for two subjects, or multiple names for one subject)
**[[BattleIntelligence:Authority control|Authority control]] metadata, if needed, using {{tlx|Authority control}} (distinguishes uses of the same name for two subjects, or multiple names for one subject)
**[[BattleTechWiki:Categorization|Categories]], which should be the very last material in the article's source code
**[[BattleIntelligence:Categorization|Categories]], which should be the very last material in the article's source code


[[BattleTechWiki:Stand-alone lists|Stand-alone list articles]] have some additional layout considerations.
[[BattleIntelligence:Stand-alone lists|Stand-alone list articles]] have some additional layout considerations.


===Section headings<span class="anchor" id="Section management"></span>===
===Section headings<span class="anchor" id="Section management"></span>===
{{Shortcut|MOS:HEAD|MOS:HEADINGS|MOS:SECTIONS|MOS:SECTIONHEAD}}
{{Shortcut|MOS:HEAD|MOS:HEADINGS|MOS:SECTIONS|MOS:SECTIONHEAD}}
{{See also|Help:Section|BattleTechWiki:Manual of Style/Accessibility#Headings|BattleTechWiki:Manual of Style/Layout#Order of article elements|BattleTechWiki:Manual of Style/Capital letters#Section headings}}
{{See also|Help:Section|BattleIntelligence:Manual of Style/Accessibility#Headings|BattleIntelligence:Manual of Style/Layout#Order of article elements|BattleIntelligence:Manual of Style/Capital letters#Section headings}}


Section headings should generally follow the guidance for [[#Article titles|article titles]] (above), and should be presented in [[sentence case]] ({{xt|Funding of UNESCO projects in developing countries}}), not title case ({{!xt|Funding of UNESCO Projects in Developing Countries}}).
Section headings should generally follow the guidance for [[#Article titles|article titles]] (above), and should be presented in [[sentence case]] ({{xt|Funding of UNESCO projects in developing countries}}), not title case ({{!xt|Funding of UNESCO Projects in Developing Countries}}).
Line 92: Line 92:
*{{Anchor|Section headings (necessary point 1)}}Be unique within a page, so that [[Template:Section link|section link]]s lead to the right place.
*{{Anchor|Section headings (necessary point 1)}}Be unique within a page, so that [[Template:Section link|section link]]s lead to the right place.
{{shortcut|MOS:NOSECTIONLINKS}}
{{shortcut|MOS:NOSECTIONLINKS}}
*{{Anchor|Section headings (necessary point 2)}}Not contain [[BattleTechWiki:Manual of Style/Linking#Principles|link]]s, especially where only part of a heading is linked.
*{{Anchor|Section headings (necessary point 2)}}Not contain [[BattleIntelligence:Manual of Style/Linking#Principles|link]]s, especially where only part of a heading is linked.
*{{Anchor|Section headings (necessary point 3)}}Not contain images or [[BattleTechWiki:Manual of Style/Icons#Encyclopedic purpose|icons]].
*{{Anchor|Section headings (necessary point 3)}}Not contain images or [[BattleIntelligence:Manual of Style/Icons#Encyclopedic purpose|icons]].
*{{Anchor|Section headings (necessary point 4)}}Not contain <[[BattleTechWiki:Manual of Style/Mathematics#Typesetting of mathematical formulae|math]]> markup.
*{{Anchor|Section headings (necessary point 4)}}Not contain <[[BattleIntelligence:Manual of Style/Mathematics#Typesetting of mathematical formulae|math]]> markup.
*{{Anchor|Section headings (necessary point 5)}}Not contain citations or footnotes.
*{{Anchor|Section headings (necessary point 5)}}Not contain citations or footnotes.
*{{Anchor|Section headings (necessary point 6)}}Not misuse [[BattleTechWiki:Manual of Style/Lists#Description (definition, association) lists|description list]] markup ("<code>;</code>") to create [[BattleTechWiki:Manual of Style/Accessibility#Pseudo-headings|pseudo-headings]].
*{{Anchor|Section headings (necessary point 6)}}Not misuse [[BattleIntelligence:Manual of Style/Lists#Description (definition, association) lists|description list]] markup ("<code>;</code>") to create [[BattleIntelligence:Manual of Style/Accessibility#Pseudo-headings|pseudo-headings]].
*{{Anchor|Section headings (necessary point 7)}}Not contain template transclusions.
*{{Anchor|Section headings (necessary point 7)}}Not contain template transclusions.


Line 107: Line 107:
*{{Anchor|Section headings (style point 3)}}Not be numbered or lettered as an outline.
*{{Anchor|Section headings (style point 3)}}Not be numbered or lettered as an outline.
*{{Anchor|Section headings (style point 4)}}Not be phrased as a question, e.g., {{xt|Languages}}, not {{!xt|What languages are spoken in Mexico?}}.
*{{Anchor|Section headings (style point 4)}}Not be phrased as a question, e.g., {{xt|Languages}}, not {{!xt|What languages are spoken in Mexico?}}.
*{{Anchor|Section headings (style point 5)}}Not use color or unusual fonts that might cause [[BattleTechWiki:Manual of Style/Accessibility#Headings|accessibility problems]].
*{{Anchor|Section headings (style point 5)}}Not use color or unusual fonts that might cause [[BattleIntelligence:Manual of Style/Accessibility#Headings|accessibility problems]].
*{{Anchor|Section headings (style point 6)}}Not be wrapped in [[Help:Wikitext|markup]], which may break their display and cause other accessibility issues.
*{{Anchor|Section headings (style point 6)}}Not be wrapped in [[Help:Wikitext|markup]], which may break their display and cause other accessibility issues.


Line 133: Line 133:
}}
}}


The advantage of using <code><nowiki>{{subst:Anchor}}</nowiki></code>, or simply inserting the <code><nowiki><span></nowiki></code> tags directly, is that when edits are made to the section in the future, the anchor will not be included in page history entries as part of the section name. When <code><nowiki>{{Anchor}}</nowiki></code> is used directly, that undesirable behavior ''does'' occur. Note: if electing to insert the span directly, do not abbreviate it by using a self-closing tag, as in <code><nowiki>==Implications<span id="Consequences" />==</nowiki></code>, since in HTML5 that XML-style syntax is valid only for certain tags, such as {{nowrap |<code>&lt;br /></code>}}. See {{section link|BattleTechWiki:Manual of Style/Linking|Avoiding broken section links}} for further discussion.
The advantage of using <code><nowiki>{{subst:Anchor}}</nowiki></code>, or simply inserting the <code><nowiki><span></nowiki></code> tags directly, is that when edits are made to the section in the future, the anchor will not be included in page history entries as part of the section name. When <code><nowiki>{{Anchor}}</nowiki></code> is used directly, that undesirable behavior ''does'' occur. Note: if electing to insert the span directly, do not abbreviate it by using a self-closing tag, as in <code><nowiki>==Implications<span id="Consequences" />==</nowiki></code>, since in HTML5 that XML-style syntax is valid only for certain tags, such as {{nowrap |<code>&lt;br /></code>}}. See {{section link|BattleIntelligence:Manual of Style/Linking|Avoiding broken section links}} for further discussion.


====Heading-like material====
====Heading-like material====
The above guidance about sentence case, redundancy, images, and questions also applies to [[BattleTechWiki:Manual of Style/Tables#Captions and headers|headers of tables]] (and of table columns and rows). However, table headings can incorporate citations and may begin with, or be, numbers. Unlike page headings, table headers do not automatically generate link anchors. Aside from sentence case in glossaries, the heading advice also applies to the ''term'' entries in [[BattleTechWiki:Manual of Style/Lists#DLIST|description lists]]. If using [[BattleTechWiki:Manual of Style/Glossaries#Linking|template-structured glossaries]], terms will automatically have link anchors, but will not otherwise. Citations for description-list content go in the ''term'' or ''definition'' element, as needed.
The above guidance about sentence case, redundancy, images, and questions also applies to [[BattleIntelligence:Manual of Style/Tables#Captions and headers|headers of tables]] (and of table columns and rows). However, table headings can incorporate citations and may begin with, or be, numbers. Unlike page headings, table headers do not automatically generate link anchors. Aside from sentence case in glossaries, the heading advice also applies to the ''term'' entries in [[BattleIntelligence:Manual of Style/Lists#DLIST|description lists]]. If using [[BattleIntelligence:Manual of Style/Glossaries#Linking|template-structured glossaries]], terms will automatically have link anchors, but will not otherwise. Citations for description-list content go in the ''term'' or ''definition'' element, as needed.


==National varieties of English==
==National varieties of English==
{{Shortcut|MOS:ENGVAR}}
{{Shortcut|MOS:ENGVAR}}
{{see also|BattleTechWiki:Article titles#National varieties of English|BattleTechWiki:Manual of Style/Spelling}}
{{see also|BattleIntelligence:Article titles#National varieties of English|BattleIntelligence:Manual of Style/Spelling}}


National varieties of English (for example, [[American English]] or [[British English]]) differ in vocabulary (''elevator'' vs. ''lift''{{hairspace}}), spelling (''center'' vs. ''centre''), and occasionally grammar {{crossref|(see {{section link||Plurals}}, below)}}. Articles such as [[English plurals]] and [[Comparison of American and British English]] provide information about such differences. The English BattleTechWiki prefers no national variety over others.
National varieties of English (for example, [[American English]] or [[British English]]) differ in vocabulary (''elevator'' vs. ''lift''{{hairspace}}), spelling (''center'' vs. ''centre''), and occasionally grammar {{crossref|(see {{section link||Plurals}}, below)}}. Articles such as [[English plurals]] and [[Comparison of American and British English]] provide information about such differences. The English BattleIntelligence prefers no national variety over others.


An article's date formatting ({{xt|{{#time: F j, Y}}}} vs. {{xt|{{#time: j F Y}}}}) is also related to national varieties of English{{snd}}see [[MOS:DATEFORMAT]] and especially [[MOS:DATETIES]] and [[MOS:DATEVAR]].
An article's date formatting ({{xt|{{#time: F j, Y}}}} vs. {{xt|{{#time: j F Y}}}}) is also related to national varieties of English{{snd}}see [[MOS:DATEFORMAT]] and especially [[MOS:DATETIES]] and [[MOS:DATEVAR]].
Line 148: Line 148:
===Consistency within articles<span class="anchor" id="Internal consistency"></span>===
===Consistency within articles<span class="anchor" id="Internal consistency"></span>===
{{Shortcut|MOS:ARTCON|MOS:CONSISTENT}}
{{Shortcut|MOS:ARTCON|MOS:CONSISTENT}}
{{hatnote|See also [[BattleTechWiki:Consistency]] for additional policies and guidelines on consistency.}}
{{hatnote|See also [[BattleIntelligence:Consistency]] for additional policies and guidelines on consistency.}}


{{em|Within a given article}} the conventions of one particular variety of English should be followed consistently. Exceptions include:
{{em|Within a given article}} the conventions of one particular variety of English should be followed consistently. Exceptions include:
*'''Quotations, titles of works (books, films, etc.)''' should be as given in the source (but see {{section link||Typographic conformity}}, below);
*'''Quotations, titles of works (books, films, etc.)''' should be as given in the source (but see {{section link||Typographic conformity}}, below);
*'''Proper names''' use the subject's own spelling, e.g., {{xt|joint project of the United States Department of Defense and the Australian Defence Force}}; {{xt|International Labour Organization}}<!--This example is here because it uses -our and -ization at the same time; it is Oxford spelling.-->;
*'''Proper names''' use the subject's own spelling, e.g., {{xt|joint project of the United States Department of Defense and the Australian Defence Force}}; {{xt|International Labour Organization}}<!--This example is here because it uses -our and -ization at the same time; it is Oxford spelling.-->;
*For articles about '''chemistry'''-related topics, the international standard spellings {{xt|aluminium}}, {{xt|sulfur}}, {{xt|caesium}} (and derivative terms) should be used, regardless of the national English variant employed in the article generally. See {{section link|BattleTechWiki:Naming conventions (chemistry)|Element names}}.
*For articles about '''chemistry'''-related topics, the international standard spellings {{xt|aluminium}}, {{xt|sulfur}}, {{xt|caesium}} (and derivative terms) should be used, regardless of the national English variant employed in the article generally. See {{section link|BattleIntelligence:Naming conventions (chemistry)|Element names}}.


===Opportunities for commonality===
===Opportunities for commonality===
Line 160: Line 160:
For an international encyclopedia, using vocabulary common to all varieties of English is preferable.
For an international encyclopedia, using vocabulary common to all varieties of English is preferable.
*Use universally accepted terms rather than those less widely distributed, especially in titles. For example, [[Glasses|{{xt|glasses}}]] is preferred to the national varieties {{!xt|spectacles}} ([[British English]]) and {{!xt|eyeglasses}} ([[American English]]); [[Ten million|{{xt|ten million}}]] is preferable to [[crore|{{!xt|one crore}}]] ([[Indian English]]).
*Use universally accepted terms rather than those less widely distributed, especially in titles. For example, [[Glasses|{{xt|glasses}}]] is preferred to the national varieties {{!xt|spectacles}} ([[British English]]) and {{!xt|eyeglasses}} ([[American English]]); [[Ten million|{{xt|ten million}}]] is preferable to [[crore|{{!xt|one crore}}]] ([[Indian English]]).
*If a variant spelling appears in a title, make a [[BattleTechWiki:Redirect|redirect]] page to accommodate the others, as with [[artefact]] and [[artifact]], so that all variants can be used in searches and linking.
*If a variant spelling appears in a title, make a [[BattleIntelligence:Redirect|redirect]] page to accommodate the others, as with [[artefact]] and [[artifact]], so that all variants can be used in searches and linking.
*Terms that differ between varieties of English, or that have divergent meanings, may be [[Gloss (annotation)#In linguistics|glossed]] to prevent confusion, for example, {{xt|the trunk (American English) or boot (British English) of a car&nbsp;...}}.
*Terms that differ between varieties of English, or that have divergent meanings, may be [[Gloss (annotation)#In linguistics|glossed]] to prevent confusion, for example, {{xt|the trunk (American English) or boot (British English) of a car&nbsp;...}}.
*Use a commonly understood word or phrase in preference to one that has a different meaning because of national differences (rather than {{!xt|alternate}}, use {{xt|alternative}} or {{xt|alternating}}, as appropriate), except in technical contexts where such substitution would be inappropriate ({{xt|alternate leaves}}; {{xt|alternate law}}).
*Use a commonly understood word or phrase in preference to one that has a different meaning because of national differences (rather than {{!xt|alternate}}, use {{xt|alternative}} or {{xt|alternating}}, as appropriate), except in technical contexts where such substitution would be inappropriate ({{xt|alternate leaves}}; {{xt|alternate law}}).
Line 169: Line 169:
===Strong national ties to a topic===
===Strong national ties to a topic===
{{Shortcut|MOS:TIES}}
{{Shortcut|MOS:TIES}}
{{See also|BattleTechWiki:Manual of Style/Dates and numbers#Strong national ties to a topic|BattleTechWiki:Manual of Style/Dates and numbers#Unit choice and order}}
{{See also|BattleIntelligence:Manual of Style/Dates and numbers#Strong national ties to a topic|BattleIntelligence:Manual of Style/Dates and numbers#Unit choice and order}}


An article on a topic that has strong ties to a particular English-speaking nation should use the (formal, not colloquial) English of that nation. For example:
An article on a topic that has strong ties to a particular English-speaking nation should use the (formal, not colloquial) English of that nation. For example:
Line 194: Line 194:
===Retaining the existing variety===
===Retaining the existing variety===
{{Shortcut|MOS:RETAIN}}
{{Shortcut|MOS:RETAIN}}
{{See also|#Retaining existing styles|BattleTechWiki:Manual of Style/Dates and numbers#Retaining the existing format}}
{{See also|#Retaining existing styles|BattleIntelligence:Manual of Style/Dates and numbers#Retaining the existing format}}
{{redirect|BTW:RETAIN|the general editing policy|BTW:PRESERVE|the title policy|BTW:TITLEVAR}}
{{redirect|BTW:RETAIN|the general editing policy|BTW:PRESERVE|the title policy|BTW:TITLEVAR}}


When an English variety's [[#Consistency within articles|consistent usage]] has been established in an article, maintain it in the absence of consensus to the contrary. With few exceptions (e.g., when a topic has [[#Strong national ties to a topic|strong national ties]] or the change reduces ambiguity), there is no valid reason for changing from one acceptable option to another.
When an English variety's [[#Consistency within articles|consistent usage]] has been established in an article, maintain it in the absence of consensus to the contrary. With few exceptions (e.g., when a topic has [[#Strong national ties to a topic|strong national ties]] or the change reduces ambiguity), there is no valid reason for changing from one acceptable option to another.


{{anchor|FPSR|FMC}}When no English variety has been established and discussion does not resolve the issue, use the variety found in the first post-[[BattleTechWiki:Stub|stub]] revision that introduced an identifiable variety. The established variety in a given article can be documented by placing the appropriate [[:Category:Varieties of English templates|variety of English template]] on its talk page.
{{anchor|FPSR|FMC}}When no English variety has been established and discussion does not resolve the issue, use the variety found in the first post-[[BattleIntelligence:Stub|stub]] revision that introduced an identifiable variety. The established variety in a given article can be documented by placing the appropriate [[:Category:Varieties of English templates|variety of English template]] on its talk page.


An article should not be edited or renamed simply to switch from one variety of English to another. {{tlxs|uw-engvar}} may be placed on an editor's talk page to explain this.
An article should not be edited or renamed simply to switch from one variety of English to another. {{tlxs|uw-engvar}} may be placed on an editor's talk page to explain this.


==Capital letters==
==Capital letters==
{{Main|BattleTechWiki:Manual of Style/Capital letters}}
{{Main|BattleIntelligence:Manual of Style/Capital letters}}


BattleTechWiki article titles and section headings use sentence case, not title case; see [[BattleTechWiki:Article titles]] and {{section link||Section headings}}. For capitalization of list items, see {{section link||Bulleted and numbered lists}}. Other points concerning capitalization are summarized below. Full information can be found at [[BattleTechWiki:Manual of Style/Capital letters]]. The central point is that BattleTechWiki does not capitalize something unless it is consistently capitalized in a substantial majority of independent, [[BattleTechWiki:Reliable sources|reliable sources]].
BattleIntelligence article titles and section headings use sentence case, not title case; see [[BattleIntelligence:Article titles]] and {{section link||Section headings}}. For capitalization of list items, see {{section link||Bulleted and numbered lists}}. Other points concerning capitalization are summarized below. Full information can be found at [[BattleIntelligence:Manual of Style/Capital letters]]. The central point is that BattleIntelligence does not capitalize something unless it is consistently capitalized in a substantial majority of independent, [[BattleIntelligence:Reliable sources|reliable sources]].


===Capitalization of ''The''===
===Capitalization of ''The''===
{{Main|BattleTechWiki:Manual of Style/Capital letters#Capitalization of The}}
{{Main|BattleIntelligence:Manual of Style/Capital letters#Capitalization of The}}


Generally, do not capitalize the word ''the'' in mid-sentence: {{xt|throughout the United Kingdom}}, not {{!xt|throughout The United Kingdom}}. Conventional exceptions include certain proper names ({{xt|he visited The Hague}}) and most titles of creative works ({{xt|Tolkien wrote ''The Lord of the Rings''}}{{snd}}but be aware that ''the'' may not be part of the title itself, e.g., {{xt|Homer composed the ''Odyssey''}}).
Generally, do not capitalize the word ''the'' in mid-sentence: {{xt|throughout the United Kingdom}}, not {{!xt|throughout The United Kingdom}}. Conventional exceptions include certain proper names ({{xt|he visited The Hague}}) and most titles of creative works ({{xt|Tolkien wrote ''The Lord of the Rings''}}{{snd}}but be aware that ''the'' may not be part of the title itself, e.g., {{xt|Homer composed the ''Odyssey''}}).


There are special considerations for: [[BattleTechWiki:Manual of Style/Music#Names (definite article)|band names]] &middot;&nbsp;[[BattleTechWiki:Manual of Style/Capital letters#Institutions|institution names]] &middot;&nbsp;[[BattleTechWiki:Manual of Style/Biography#NICKNAMETHE|nicknames]] &middot;&nbsp;[[BattleTechWiki:Manual of Style/Titles#Indefinite and definite articles|titles of works]] &middot;&nbsp;[[BattleTechWiki:Manual of Style/Trademarks#TMTHE|trademarks]].
There are special considerations for: [[BattleIntelligence:Manual of Style/Music#Names (definite article)|band names]] &middot;&nbsp;[[BattleIntelligence:Manual of Style/Capital letters#Institutions|institution names]] &middot;&nbsp;[[BattleIntelligence:Manual of Style/Biography#NICKNAMETHE|nicknames]] &middot;&nbsp;[[BattleIntelligence:Manual of Style/Titles#Indefinite and definite articles|titles of works]] &middot;&nbsp;[[BattleIntelligence:Manual of Style/Trademarks#TMTHE|trademarks]].


===Titles of works<span id="Capitalization-Titles"></span>===
===Titles of works<span id="Capitalization-Titles"></span>===
{{main|BTW:Manual of Style/Titles of works}}
{{main|BTW:Manual of Style/Titles of works}}


The English-language titles of compositions (books and other print works, songs and other audio works, films and other visual media works, paintings and other artworks, etc.) are given in {{em|[[title case]]}}, in which every word is given an initial capital except for certain less important words (as detailed at {{section link|BattleTechWiki:Manual of Style/Capital letters|Composition titles}}). The first and last words in an English-language title are always capitalized.
The English-language titles of compositions (books and other print works, songs and other audio works, films and other visual media works, paintings and other artworks, etc.) are given in {{em|[[title case]]}}, in which every word is given an initial capital except for certain less important words (as detailed at {{section link|BattleIntelligence:Manual of Style/Capital letters|Composition titles}}). The first and last words in an English-language title are always capitalized.
*{{em|Correct:}} {{xt|''An Eye for an Eye''}}
*{{em|Correct:}} {{xt|''An Eye for an Eye''}}
*{{em|Correct:}} {{xt|''Worth the Fighting For''}}
*{{em|Correct:}} {{xt|''Worth the Fighting For''}}
Line 227: Line 227:


===Titles of people===
===Titles of people===
{{Main|BattleTechWiki:Manual of Style/Biography#Titles of people}}
{{Main|BattleIntelligence:Manual of Style/Biography#Titles of people}}
*'''In generic use''', use lower case for words such as ''president'', ''king'', and ''emperor'' ({{xt|De Gaulle was a French president}}; {{xt|Louis XVI was a French king}}; {{xt|Three prime ministers attended the conference}}).
*'''In generic use''', use lower case for words such as ''president'', ''king'', and ''emperor'' ({{xt|De Gaulle was a French president}}; {{xt|Louis XVI was a French king}}; {{xt|Three prime ministers attended the conference}}).
*'''Directly before the person's name''', such words begin with a capital letter ({{xt|President Obama}}, not {{!xt|president Obama}}). Standard or commonly used names of an office are treated as proper names ({{xt|David Cameron was Prime Minister of the United Kingdom}}; {{xt|Hirohito was Emperor of Japan}}; {{xt|Louis XVI was King of France}}). Royal styles take capitals ({{xt|Her Majesty}}; {{xt|His Highness}}); exceptions may apply for particular offices.
*'''Directly before the person's name''', such words begin with a capital letter ({{xt|President Obama}}, not {{!xt|president Obama}}). Standard or commonly used names of an office are treated as proper names ({{xt|David Cameron was Prime Minister of the United Kingdom}}; {{xt|Hirohito was Emperor of Japan}}; {{xt|Louis XVI was King of France}}). Royal styles take capitals ({{xt|Her Majesty}}; {{xt|His Highness}}); exceptions may apply for particular offices.


===Religions, deities, philosophies, doctrines===
===Religions, deities, philosophies, doctrines===
{{Main|BattleTechWiki:Manual of Style/Capital letters#Religions, deities, philosophies, doctrines, and their adherents}}
{{Main|BattleIntelligence:Manual of Style/Capital letters#Religions, deities, philosophies, doctrines, and their adherents}}
{{see|BattleTechWiki:Manual of Style/Religion}}
{{see|BattleIntelligence:Manual of Style/Religion}}
{{See also|BattleTechWiki:Manual of Style/Titles#Religious texts}}
{{See also|BattleIntelligence:Manual of Style/Titles#Religious texts}}
*'''Religions, sects, and churches''' and their followers (in noun or adjective form) start with a capital letter. Generally, "the" is not capitalized before such names ({{xt|the Unitarians}}, not {{!xt|The Unitarians}}).
*'''Religions, sects, and churches''' and their followers (in noun or adjective form) start with a capital letter. Generally, "the" is not capitalized before such names ({{xt|the Unitarians}}, not {{!xt|The Unitarians}}).
*'''[[Religious text]]s''' are capitalized, but often not italicized ({{xt|the Bhagavad Gita}}, {{xt|the Quran}}, {{xt|the Talmud}}, {{xt|the Granth Sahib}}, {{xt|the Bible}}). Do not capitalize "the" when using it in this way. Some derived adjectives are capitalized by convention, and some are not ({{xt|biblical}}, but {{xt|Quranic}}); if unsure, check a dictionary.
*'''[[Religious text]]s''' are capitalized, but often not italicized ({{xt|the Bhagavad Gita}}, {{xt|the Quran}}, {{xt|the Talmud}}, {{xt|the Granth Sahib}}, {{xt|the Bible}}). Do not capitalize "the" when using it in this way. Some derived adjectives are capitalized by convention, and some are not ({{xt|biblical}}, but {{xt|Quranic}}); if unsure, check a dictionary.
Line 243: Line 243:
*'''Philosophies, theories, movements, and doctrines''' use lower case unless the name derives from a proper name ({{xt|capitalism versus Marxism}}) or has become a proper name ({{xt|republican}}, a system of political thought; {{xt|Republican}}, a political party). Use lower case for doctrinal topics or canonical religious ideas (as opposed to specific events), even if they are capitalized by some religious adherents ({{xt|virgin birth}}, {{xt|original sin}}, {{xt|transubstantiation}}).
*'''Philosophies, theories, movements, and doctrines''' use lower case unless the name derives from a proper name ({{xt|capitalism versus Marxism}}) or has become a proper name ({{xt|republican}}, a system of political thought; {{xt|Republican}}, a political party). Use lower case for doctrinal topics or canonical religious ideas (as opposed to specific events), even if they are capitalized by some religious adherents ({{xt|virgin birth}}, {{xt|original sin}}, {{xt|transubstantiation}}).
*'''[[Platonic idealism|Platonic]] or transcendent ideals''' are capitalized in the context of philosophical doctrine ({{xt|Truth}}, {{xt|the Good}}); used more broadly, they are in lower case ({{xt|Superman represents American ideals of truth and justice}}). Use capitals for personifications represented in art ({{xt|the guidebook mentioned statues of Justice and Liberty}}).
*'''[[Platonic idealism|Platonic]] or transcendent ideals''' are capitalized in the context of philosophical doctrine ({{xt|Truth}}, {{xt|the Good}}); used more broadly, they are in lower case ({{xt|Superman represents American ideals of truth and justice}}). Use capitals for personifications represented in art ({{xt|the guidebook mentioned statues of Justice and Liberty}}).
*{{anchor|Eponyms|EPONYM|EPONYMS}}'''[[Eponym]]s''' are capitalized ([[Edwardian era|{{xt|Edwardian}}]], [[De Morgan's laws|{{xt|De Morgan's laws}}]], [[Alice in Wonderland syndrome|{{xt|Alice in Wonderland syndrome}}]], [[Plaster of Paris|{{xt|plaster of Paris}}]], [[Platonic idealism|{{xt|Platonic idealism}}]], [[Draconian constitution|{{xt|Draconian constitution of Athens}}]]), except in idiomatic uses disconnected from the original context and usually lower-cased in sources ([[Platonic relationship|{{xt|a platonic relationship}}]]; {{xt|complained of draconian workplace policies}}). An entire phrase in which an eponym is an adjective [[BattleTechWiki:Manual of Style/Capital letters#Religions, deities, philosophies, doctrines, and their adherents|is not capitalized]] except when the phrase is itself a proper name (e.g., the [[BattleTechWiki:Manual of Style/Titles|title of a published work]]: [[The China Syndrome|{{xt|''The China Syndrome''}}]]).
*{{anchor|Eponyms|EPONYM|EPONYMS}}'''[[Eponym]]s''' are capitalized ([[Edwardian era|{{xt|Edwardian}}]], [[De Morgan's laws|{{xt|De Morgan's laws}}]], [[Alice in Wonderland syndrome|{{xt|Alice in Wonderland syndrome}}]], [[Plaster of Paris|{{xt|plaster of Paris}}]], [[Platonic idealism|{{xt|Platonic idealism}}]], [[Draconian constitution|{{xt|Draconian constitution of Athens}}]]), except in idiomatic uses disconnected from the original context and usually lower-cased in sources ([[Platonic relationship|{{xt|a platonic relationship}}]]; {{xt|complained of draconian workplace policies}}). An entire phrase in which an eponym is an adjective [[BattleIntelligence:Manual of Style/Capital letters#Religions, deities, philosophies, doctrines, and their adherents|is not capitalized]] except when the phrase is itself a proper name (e.g., the [[BattleIntelligence:Manual of Style/Titles|title of a published work]]: [[The China Syndrome|{{xt|''The China Syndrome''}}]]).


===Calendar items===
===Calendar items===
{{Main|BattleTechWiki:Manual of Style/Capital letters#Calendar items}}
{{Main|BattleIntelligence:Manual of Style/Capital letters#Calendar items}}
*'''Months, days of the week, and holidays''' start with a capital letter ({{xt|June}}, {{xt|Monday}}; {{xt|the Fourth of July}} refers only to the US Independence Day{{snd}}otherwise {{xt|July 4}} or {{xt|4 July}}).
*'''Months, days of the week, and holidays''' start with a capital letter ({{xt|June}}, {{xt|Monday}}; {{xt|the Fourth of July}} refers only to the US Independence Day{{snd}}otherwise {{xt|July 4}} or {{xt|4 July}}).
*'''Seasons''' are in lower case ({{xt|her last summer}}; {{xt|the winter solstice}}; {{xt|spring fever}}), except in personifications or in proper names for periods or events ({{xt|Old Man Winter}}; {{xt|competed on the Spring Circuit}}).
*'''Seasons''' are in lower case ({{xt|her last summer}}; {{xt|the winter solstice}}; {{xt|spring fever}}), except in personifications or in proper names for periods or events ({{xt|Old Man Winter}}; {{xt|competed on the Spring Circuit}}).
Line 254: Line 254:
===Animals, plants, and other organisms===
===Animals, plants, and other organisms===
{{Shortcut|MOS:LIFE}}
{{Shortcut|MOS:LIFE}}
{{Hatnote|For more detail on capitalization, see {{section link|BattleTechWiki:Manual of Style/Capital letters|Animals, plants, and other organisms}}; on italicization, {{section link|BattleTechWiki:Manual of Style/Text formatting|Italic face}}. See also {{section link|BattleTechWiki:Lead section|Organisms}} for handling of first sentence. See [[BattleTechWiki:Naming conventions (fauna)]] and [[BattleTechWiki:Naming conventions (flora)]] for article title guidelines.}}
{{Hatnote|For more detail on capitalization, see {{section link|BattleIntelligence:Manual of Style/Capital letters|Animals, plants, and other organisms}}; on italicization, {{section link|BattleIntelligence:Manual of Style/Text formatting|Italic face}}. See also {{section link|BattleIntelligence:Lead section|Organisms}} for handling of first sentence. See [[BattleIntelligence:Naming conventions (fauna)]] and [[BattleIntelligence:Naming conventions (flora)]] for article title guidelines.}}


When using '''[[Taxonomy (biology)|taxonomic ("scientific") names]]''', capitalize and italicize the genus: {{xt|''Berberis''}}, {{xt|''Erithacus''}}. (Supergenus and subgenus, when applicable, are treated the same way.) Italicize but do not capitalize taxonomic ranks at the level of species and below: {{xt|''Berberis darwinii''}}, {{xt|''Erithacus rubecula superbus''}}, {{xt|''Acacia coriacea'' subsp. ''sericophylla''}}; no exception is made for proper names forming part of scientific names. Higher taxa (order, family, etc.) are capitalized in Latin ({{xt|Carnivora}}, {{xt|Felidae}}) but not in their English equivalents ({{xt|carnivorans}}, {{xt|felids}}); they are not italicized in either form, except for viruses, where all names accepted by the [[International Committee on Taxonomy of Viruses|ICTV]] are italicized ({{xt|''Retroviridae''}}).
When using '''[[Taxonomy (biology)|taxonomic ("scientific") names]]''', capitalize and italicize the genus: {{xt|''Berberis''}}, {{xt|''Erithacus''}}. (Supergenus and subgenus, when applicable, are treated the same way.) Italicize but do not capitalize taxonomic ranks at the level of species and below: {{xt|''Berberis darwinii''}}, {{xt|''Erithacus rubecula superbus''}}, {{xt|''Acacia coriacea'' subsp. ''sericophylla''}}; no exception is made for proper names forming part of scientific names. Higher taxa (order, family, etc.) are capitalized in Latin ({{xt|Carnivora}}, {{xt|Felidae}}) but not in their English equivalents ({{xt|carnivorans}}, {{xt|felids}}); they are not italicized in either form, except for viruses, where all names accepted by the [[International Committee on Taxonomy of Viruses|ICTV]] are italicized ({{xt|''Retroviridae''}}).
Line 262: Line 262:
'''English [[Common name|vernacular ("common") names]]''' are given in lower case in article prose ([[Plains zebra|{{xt|plains zebra}}]]<!-- animal species -->, [[Mountain maple|{{xt|mountain&nbsp;maple}}]]<!-- plant species -->, and [[Southwestern red-tailed hawk|{{xt|southwestern red-tailed hawk}}]]<!-- bird subspecies -->) and in sentence case at the start of sentences and in other places where the first letter of the first word is capitalized. They are additionally capitalized where they contain proper names: [[Przewalski's horse|{{xt|Przewalski's&nbsp;horse}}]]<!-- eponym -->, [[California condor|{{xt|California&nbsp;condor}}]]<!-- typical geonym -->, and [[Fair-maid-of-France|{{xt|fair-maid-of-France}}]]<!-- unusual but important illustrative case -->. This applies to species and subspecies, as in the previous examples, as well as to general names for groups or types of organism: [[Bird of prey|{{xt|bird&nbsp;of&nbsp;prey}}]]<!-- cross-order ecological niche -->, [[Oak|{{xt|oak}}]]<!-- plant family -->, [[Great apes|{{xt|great&nbsp;apes}}]]<!-- animal family -->, [[Bryde's whales|{{xt|Bryde's&nbsp;whales}}]]<!-- species group -->, [[Livestock guardian dog|{{xt|livestock&nbsp;guardian&nbsp;dog}}]]<!-- domestic type -->, [[Poodle|{{xt|poodle}}]]<!-- domestic breed group but not a breed -->, [[Van cat|{{xt|Van&nbsp;cat}}]]<!-- domestic geographic landrace -->, [[Wolfdog|{{xt|wolfdog}}]]<!-- hybrid/crossbreed/mongrel not recognized as a standardized breed -->. When the common name coincides with a scientific taxon, do not capitalize or italicize, except where addressing the organism taxonomically: {{xt|A lynx is any of the four medium-sized wild cat species within the genus ''Lynx''.}} Non-English vernacular names, when relevant to include, are handled like any other foreign-language terms: italicized as such, and capitalized only if the rules of the native language require it. Non-English names that have become English-assimilated are treated as English ([[Ayahuasca|{{xt|ayahuasca}}]], [[Okapi|{{xt|okapi}}]]).
'''English [[Common name|vernacular ("common") names]]''' are given in lower case in article prose ([[Plains zebra|{{xt|plains zebra}}]]<!-- animal species -->, [[Mountain maple|{{xt|mountain&nbsp;maple}}]]<!-- plant species -->, and [[Southwestern red-tailed hawk|{{xt|southwestern red-tailed hawk}}]]<!-- bird subspecies -->) and in sentence case at the start of sentences and in other places where the first letter of the first word is capitalized. They are additionally capitalized where they contain proper names: [[Przewalski's horse|{{xt|Przewalski's&nbsp;horse}}]]<!-- eponym -->, [[California condor|{{xt|California&nbsp;condor}}]]<!-- typical geonym -->, and [[Fair-maid-of-France|{{xt|fair-maid-of-France}}]]<!-- unusual but important illustrative case -->. This applies to species and subspecies, as in the previous examples, as well as to general names for groups or types of organism: [[Bird of prey|{{xt|bird&nbsp;of&nbsp;prey}}]]<!-- cross-order ecological niche -->, [[Oak|{{xt|oak}}]]<!-- plant family -->, [[Great apes|{{xt|great&nbsp;apes}}]]<!-- animal family -->, [[Bryde's whales|{{xt|Bryde's&nbsp;whales}}]]<!-- species group -->, [[Livestock guardian dog|{{xt|livestock&nbsp;guardian&nbsp;dog}}]]<!-- domestic type -->, [[Poodle|{{xt|poodle}}]]<!-- domestic breed group but not a breed -->, [[Van cat|{{xt|Van&nbsp;cat}}]]<!-- domestic geographic landrace -->, [[Wolfdog|{{xt|wolfdog}}]]<!-- hybrid/crossbreed/mongrel not recognized as a standardized breed -->. When the common name coincides with a scientific taxon, do not capitalize or italicize, except where addressing the organism taxonomically: {{xt|A lynx is any of the four medium-sized wild cat species within the genus ''Lynx''.}} Non-English vernacular names, when relevant to include, are handled like any other foreign-language terms: italicized as such, and capitalized only if the rules of the native language require it. Non-English names that have become English-assimilated are treated as English ([[Ayahuasca|{{xt|ayahuasca}}]], [[Okapi|{{xt|okapi}}]]).


Create [[BattleTechWiki:Redirect|redirects]] from alternative capitalization and spelling forms of article titles, and from alternative names, e.g., [[Adélie Penguin]], [[Adelie penguin]], [[Adelie Penguin]] and ''[[Pygoscelis adeliae]]'' should all redirect to [[Adélie penguin]].
Create [[BattleIntelligence:Redirect|redirects]] from alternative capitalization and spelling forms of article titles, and from alternative names, e.g., [[Adélie Penguin]], [[Adelie penguin]], [[Adelie Penguin]] and ''[[Pygoscelis adeliae]]'' should all redirect to [[Adélie penguin]].


===Celestial bodies===
===Celestial bodies===
{{Main|BattleTechWiki:Manual of Style/Capital letters#Celestial bodies}}
{{Main|BattleIntelligence:Manual of Style/Capital letters#Celestial bodies}}
{{See also|BattleTechWiki:Naming conventions (astronomical objects)}}
{{See also|BattleIntelligence:Naming conventions (astronomical objects)}}
The words ''sun'', ''earth'', ''moon'' and ''solar system'' do not take capitals in general use ({{xt|The sun was over the mountain top}}; {{xt|The tribal people thought of the whole earth as their home}}). They are capitalized when the entity is personified ({{xt|Sol Invictus ('Unconquered Sun') was the Roman sun god}}) or when used as the name of a specific body in a scientific or astronomical context ({{xt|The Moon orbits the Earth}}; but {{xt|Io is a moon of Jupiter}}).
The words ''sun'', ''earth'', ''moon'' and ''solar system'' do not take capitals in general use ({{xt|The sun was over the mountain top}}; {{xt|The tribal people thought of the whole earth as their home}}). They are capitalized when the entity is personified ({{xt|Sol Invictus ('Unconquered Sun') was the Roman sun god}}) or when used as the name of a specific body in a scientific or astronomical context ({{xt|The Moon orbits the Earth}}; but {{xt|Io is a moon of Jupiter}}).


Line 272: Line 272:


===Compass points<span class="anchor" id="Compass"></span>===
===Compass points<span class="anchor" id="Compass"></span>===
{{Main|BattleTechWiki:Manual of Style/Capital letters#Compass points}}
{{Main|BattleIntelligence:Manual of Style/Capital letters#Compass points}}


Do not capitalize '''directions''' such as ''north'', or their related forms ({{xt|We took the northern road}}), except where they are parts of proper names ({{xt|Great North Road}}, {{xt|Great Western Drive}}, {{xt|South Pole}}).
Do not capitalize '''directions''' such as ''north'', or their related forms ({{xt|We took the northern road}}), except where they are parts of proper names ({{xt|Great North Road}}, {{xt|Great Western Drive}}, {{xt|South Pole}}).
Line 281: Line 281:


===Proper names versus generic terms<span id="Institutions"></span>===
===Proper names versus generic terms<span id="Institutions"></span>===
{{Main|BattleTechWiki:Manual of Style/Capital letters#Institutions|BattleTechWiki:Manual of Style/Capital letters#Capitalization of ''The''}}
{{Main|BattleIntelligence:Manual of Style/Capital letters#Institutions|BattleIntelligence:Manual of Style/Capital letters#Capitalization of ''The''}}


Capitalize names of particular institutions ({{xt|the founding of the University of Delhi}};{{nbsp}} {{xt|the history of Stanford University}}) but not generic words for institutions ({{xt|the high school is near the university}}). Do not capitalize ''the'' at the start of an institution's name, regardless of the institution's preferred style. There are rare exceptions, when a leading ''The'' is represented by a ''T'' in the organization's acronym: {{xt|The International Cat Association (TICA)}}.
Capitalize names of particular institutions ({{xt|the founding of the University of Delhi}};{{nbsp}} {{xt|the history of Stanford University}}) but not generic words for institutions ({{xt|the high school is near the university}}). Do not capitalize ''the'' at the start of an institution's name, regardless of the institution's preferred style. There are rare exceptions, when a leading ''The'' is represented by a ''T'' in the organization's acronym: {{xt|The International Cat Association (TICA)}}.


Treat political or geographic units similarly: {{xt|The city has a population of 55,000}};{{nbsp}} {{xt|The two towns merged to become the City of Smithville}}. Do not mimic the style of local newspapers which refer to their municipality as ''the City'' or ''The City''; an exception is the [[City of London]], referred to as {{xt|the City}} in a context that already makes the subject clear, as distinct from [[London]] and [[Greater London]]. When in doubt, use the full name for [[BattleTechWiki:Manual of Style/Accessibility|accessibility]] reasons; users of text-to-speech systems usually cannot hear a difference between ''city'' and ''City''.
Treat political or geographic units similarly: {{xt|The city has a population of 55,000}};{{nbsp}} {{xt|The two towns merged to become the City of Smithville}}. Do not mimic the style of local newspapers which refer to their municipality as ''the City'' or ''The City''; an exception is the [[City of London]], referred to as {{xt|the City}} in a context that already makes the subject clear, as distinct from [[London]] and [[Greater London]]. When in doubt, use the full name for [[BattleIntelligence:Manual of Style/Accessibility|accessibility]] reasons; users of text-to-speech systems usually cannot hear a difference between ''city'' and ''City''.


==Ligatures==
==Ligatures==
{{See also|BattleTechWiki:Naming conventions (use English)#Modified letters}}
{{See also|BattleIntelligence:Naming conventions (use English)#Modified letters}}
{{Shortcut|MOS:LIGATURE}}
{{Shortcut|MOS:LIGATURE}}


Line 294: Line 294:


==Abbreviations<span class="anchor" id="Acronyms and abbreviations"></span><span class="anchor" id="Acronyms"></span><span class="anchor" id="Initialisms"></span><span class="anchor" id="Shortenings"></span>==
==Abbreviations<span class="anchor" id="Acronyms and abbreviations"></span><span class="anchor" id="Acronyms"></span><span class="anchor" id="Initialisms"></span><span class="anchor" id="Shortenings"></span>==
{{Main|BattleTechWiki:Manual of Style/Abbreviations}}
{{Main|BattleIntelligence:Manual of Style/Abbreviations}}
{{see also|BattleTechWiki:Manual of Style/Biography#Initials}}
{{see also|BattleIntelligence:Manual of Style/Biography#Initials}}


Abbreviations are shortened forms of words or phrases. In strict analysis, they are distinct from [[Contraction (grammar)|contractions]], which use an [[apostrophe]] (e.g., ''won't'', see {{Section link||Contractions}}), and [[initialism]]s. An initialism is formed from some or all of the initial letters of words in a phrase. Below, references to abbreviations should be taken to include acronyms, and the term ''acronym'' to apply also to initialisms.
Abbreviations are shortened forms of words or phrases. In strict analysis, they are distinct from [[Contraction (grammar)|contractions]], which use an [[apostrophe]] (e.g., ''won't'', see {{Section link||Contractions}}), and [[initialism]]s. An initialism is formed from some or all of the initial letters of words in a phrase. Below, references to abbreviations should be taken to include acronyms, and the term ''acronym'' to apply also to initialisms.
Line 313: Line 313:


===Punctuation and spacing<span class="anchor" id="Periods (full stops) and spaces"></span><span class="anchor" id="Full stops and spaces"></span><span class="anchor" id="op.cit."></span>===
===Punctuation and spacing<span class="anchor" id="Periods (full stops) and spaces"></span><span class="anchor" id="Full stops and spaces"></span><span class="anchor" id="op.cit."></span>===
An abbreviation may or may not be terminated with a full point (also called a ''period'' or ''full stop''). A consistent style should be maintained within an article. North American usage is typically to end all abbreviations with a period/point ({{xt|Dr. Smith of 42&nbsp;Drummond St.}}) but in common British and Australian usage, no period/point is used if the abbreviation (contraction) ends in the last letter of the unabbreviated form ({{xt|Dr Smith of 42&nbsp;Drummond St}}) unless confusion could result. This is also common practice in scientific writing. Regardless of punctuation, words that are abbreviated to more than one letter are spaced ({{xt|op.&nbsp;cit.}} not {{!xt|op.cit.}} or {{!xt|opcit}}). There are some exceptions: {{xt|PhD}} {{crossref|(see above)}} for "Philosophiae Doctor"; {{xt|BVetMed}} for "Bachelor of Veterinary Medicine". In most situations, BattleTechWiki uses no such punctuation inside acronyms and initialisms: {{xt|GDP}}, not {{!xt|G.D.P.}}
An abbreviation may or may not be terminated with a full point (also called a ''period'' or ''full stop''). A consistent style should be maintained within an article. North American usage is typically to end all abbreviations with a period/point ({{xt|Dr. Smith of 42&nbsp;Drummond St.}}) but in common British and Australian usage, no period/point is used if the abbreviation (contraction) ends in the last letter of the unabbreviated form ({{xt|Dr Smith of 42&nbsp;Drummond St}}) unless confusion could result. This is also common practice in scientific writing. Regardless of punctuation, words that are abbreviated to more than one letter are spaced ({{xt|op.&nbsp;cit.}} not {{!xt|op.cit.}} or {{!xt|opcit}}). There are some exceptions: {{xt|PhD}} {{crossref|(see above)}} for "Philosophiae Doctor"; {{xt|BVetMed}} for "Bachelor of Veterinary Medicine". In most situations, BattleIntelligence uses no such punctuation inside acronyms and initialisms: {{xt|GDP}}, not {{!xt|G.D.P.}}


===US and U.S.<span class="anchor" id="US"></span><span class="anchor" id="U.S."></span><span class="anchor" id="USA"></span><span class="anchor" id="U.S.A."></span>===
===US and U.S.<span class="anchor" id="US"></span><span class="anchor" id="U.S."></span><span class="anchor" id="USA"></span><span class="anchor" id="U.S.A."></span>===
{{redirect|MOS:US|the use of the word "us"|BattleTechWiki:Manual of Style#First-person pronouns}}
{{redirect|MOS:US|the use of the word "us"|BattleIntelligence:Manual of Style#First-person pronouns}}
{{Shortcut|MOS:US|MOS:USA|MOS:NOTUSA}}
{{Shortcut|MOS:US|MOS:USA|MOS:NOTUSA}}
{{xt|US}} is a commonly used abbreviation for {{xt|United States}}, although {{xtn|U.S.}} – with periods and without a space – remains common in North American publications, including in news journalism.  Multiple American style guides, including ''[[The Chicago Manual of Style]]'' (since 2010), now deprecate "U.S." and recommend "US".
{{xt|US}} is a commonly used abbreviation for {{xt|United States}}, although {{xtn|U.S.}} – with periods and without a space – remains common in North American publications, including in news journalism.  Multiple American style guides, including ''[[The Chicago Manual of Style]]'' (since 2010), now deprecate "U.S." and recommend "US".
Line 323: Line 323:


===Circa===
===Circa===
{{Hatnote|See also: {{section link|BattleTechWiki:Manual of Style/Dates and numbers|Uncertain, incomplete, or approximate dates}} for examples.}}
{{Hatnote|See also: {{section link|BattleIntelligence:Manual of Style/Dates and numbers|Uncertain, incomplete, or approximate dates}} for examples.}}


To indicate ''approximately'', the use of {{tlx|circa}}, showing as {{xt|1={{circa}}}}, is preferred over circa, c., ca., or approx.
To indicate ''approximately'', the use of {{tlx|circa}}, showing as {{xt|1={{circa}}}}, is preferred over circa, c., ca., or approx.
Line 329: Line 329:
===Avoid unwarranted use===
===Avoid unwarranted use===
<span class="anchor" id="unwarranted abbreviations"></span>
<span class="anchor" id="unwarranted abbreviations"></span>
{{Hatnote|See also: {{section link|BattleTechWiki:Manual of Style/Dates and numbers|Units of measurement}} for when to abbreviate units of measurement.}}
{{Hatnote|See also: {{section link|BattleIntelligence:Manual of Style/Dates and numbers|Units of measurement}} for when to abbreviate units of measurement.}}


Avoid abbreviations when they might confuse the reader, interrupt the flow, or appear informal. For example:
Avoid abbreviations when they might confuse the reader, interrupt the flow, or appear informal. For example:
Line 336: Line 336:


===Do not invent===
===Do not invent===
Avoid devising [[BattleTechWiki:BattleTechWiki is not a dictionary#Neologisms|new abbreviations]], especially acronyms. For example, {{xtn|World Union of Billiards}} is good as a {{em|translation}} of {{xt|[[Union Mondiale de Billard]]}}, but neither it nor the reduction {{!xt|WUB}} is used by the organization or by independent sources; use the original name and its official abbreviation, {{xt|UMB}}.
Avoid devising [[BattleIntelligence:BattleIntelligence is not a dictionary#Neologisms|new abbreviations]], especially acronyms. For example, {{xtn|World Union of Billiards}} is good as a {{em|translation}} of {{xt|[[Union Mondiale de Billard]]}}, but neither it nor the reduction {{!xt|WUB}} is used by the organization or by independent sources; use the original name and its official abbreviation, {{xt|UMB}}.


If it is necessary to abbreviate in a tight space, such as a [[BattleTechWiki:Manual of Style/Tables#Captions and headers|column header in a table]], use widely recognized abbreviations. For example, for {{xt|New Zealand gross national product}}, use {{xt|NZ}} and {{xt|GNP}}, with a link if the term has not already been written out in the article: {{xt|NZ&nbsp;[[Measures of national income and output|GNP]]}}. Do not make up initialisms such as {{!xt|NZGNP}}.
If it is necessary to abbreviate in a tight space, such as a [[BattleIntelligence:Manual of Style/Tables#Captions and headers|column header in a table]], use widely recognized abbreviations. For example, for {{xt|New Zealand gross national product}}, use {{xt|NZ}} and {{xt|GNP}}, with a link if the term has not already been written out in the article: {{xt|NZ&nbsp;[[Measures of national income and output|GNP]]}}. Do not make up initialisms such as {{!xt|NZGNP}}.


===HTML tags and templates===
===HTML tags and templates===
Line 346: Line 346:
{{Shortcut|MOS:AMP|MOS:&}}
{{Shortcut|MOS:AMP|MOS:&}}


In normal text and headings, use ''and'' instead of the [[ampersand]] (''&''): {{xt|January 1&nbsp;and&nbsp;2}}, not {{!xt|January 1&nbsp;&&nbsp;2}}. But retain an ampersand when it is a legitimate part of the style of a proper noun, the title of a work, or a trademark, such as in ''[[Up & Down (album)|Up&nbsp;&amp;&nbsp;Down]]'' or [[AT&T]]. Elsewhere, ampersands may be used with consistency and discretion where space is extremely limited (e.g., tables and infoboxes). Quotations [[BattleTechWiki:Manual of Style#Typographic conformity|may be cautiously modified]], especially for consistency where different editions are quoted, as modern editions of old texts routinely replace ampersands with ''and'' (just as they replace other disused [[glyph]]s, [[Typographic ligature|ligatures]], and abbreviations). Another frequent permissible but not required use is in short bibliographic references to works by multiple authors, e.g.: {{xt|<nowiki><ref>Lubbers & Scheepers (2002); Van Hiel & Mervielde (2002); Swyngedouw & Giles (2007); Van Hiel (2012).</ref></nowiki>}}.
In normal text and headings, use ''and'' instead of the [[ampersand]] (''&''): {{xt|January 1&nbsp;and&nbsp;2}}, not {{!xt|January 1&nbsp;&&nbsp;2}}. But retain an ampersand when it is a legitimate part of the style of a proper noun, the title of a work, or a trademark, such as in ''[[Up & Down (album)|Up&nbsp;&amp;&nbsp;Down]]'' or [[AT&T]]. Elsewhere, ampersands may be used with consistency and discretion where space is extremely limited (e.g., tables and infoboxes). Quotations [[BattleIntelligence:Manual of Style#Typographic conformity|may be cautiously modified]], especially for consistency where different editions are quoted, as modern editions of old texts routinely replace ampersands with ''and'' (just as they replace other disused [[glyph]]s, [[Typographic ligature|ligatures]], and abbreviations). Another frequent permissible but not required use is in short bibliographic references to works by multiple authors, e.g.: {{xt|<nowiki><ref>Lubbers & Scheepers (2002); Van Hiel & Mervielde (2002); Swyngedouw & Giles (2007); Van Hiel (2012).</ref></nowiki>}}.


==Italics==
==Italics==
{{Shortcut|MOS:IT|MOS:ITAL}}
{{Shortcut|MOS:IT|MOS:ITAL}}
{{Main|BattleTechWiki:Manual of Style/Text formatting#Italic type}}
{{Main|BattleIntelligence:Manual of Style/Text formatting#Italic type}}


===Emphasis<span id="Do not use capitals for emphasis"></span>===
===Emphasis<span id="Do not use capitals for emphasis"></span>===
{{Main|BattleTechWiki:Manual of Style/Text formatting#Emphasis}}
{{Main|BattleIntelligence:Manual of Style/Text formatting#Emphasis}}


Italics are used for emphasis, rather than [[BattleTechWiki:Manual of Style/Text formatting#Boldface|boldface]] or [[BattleTechWiki:Manual of Style/Capital letters#All caps and small caps|capitals]]. But overuse diminishes its effect; consider rewriting instead.
Italics are used for emphasis, rather than [[BattleIntelligence:Manual of Style/Text formatting#Boldface|boldface]] or [[BattleIntelligence:Manual of Style/Capital letters#All caps and small caps|capitals]]. But overuse diminishes its effect; consider rewriting instead.


Use {{tag|em}} or {{tlx|em|...}} for emphasis. This allows [[Help:User style|user style sheets]] to handle emphasis in a customized way, and helps reusers and translators.
Use {{tag|em}} or {{tlx|em|...}} for emphasis. This allows [[Help:User style|user style sheets]] to handle emphasis in a customized way, and helps reusers and translators.
Line 370: Line 370:


===Words as words===
===Words as words===
{{Main|BattleTechWiki:Manual of Style/Text formatting#Words as words}}
{{Main|BattleIntelligence:Manual of Style/Text formatting#Words as words}}
{{for|the policy when a word or phrase itself may be an encyclopedic subject|BTW:WORDISSUBJECT}}
{{for|the policy when a word or phrase itself may be an encyclopedic subject|BTW:WORDISSUBJECT}}


Line 400: Line 400:


==Quotations==
==Quotations==
{{See|BattleTechWiki:Do not include the full text of lengthy primary sources}}
{{See|BattleIntelligence:Do not include the full text of lengthy primary sources}}
{{for|the essay|BattleTechWiki:Quotations}}
{{for|the essay|BattleIntelligence:Quotations}}
{{Redirects here|MOS:QUOTE|the section on quotation characters|MOS:CURLY}}
{{Redirects here|MOS:QUOTE|the section on quotation characters|MOS:CURLY}}
{{Shortcut|MOS:QUOT|MOS:QUOTE|MOS:QUOTATIONS}}
{{Shortcut|MOS:QUOT|MOS:QUOTE|MOS:QUOTATIONS}}


[[BattleTechWiki:Non-free content#Guideline examples|Brief quotations of copyrighted text]] may be used to illustrate a point, establish context, or attribute a point of view or idea. While quotations are an indispensable part of BattleTechWiki, try not to overuse them. Using too many quotes is incompatible with an encyclopedic writing style and may be [[BattleTechWiki:Copyrights|copyright infringement]], and so most of the content should be in the editor's own words. Consider paraphrasing quotations into plain and concise text when appropriate (while being aware that [[BattleTechWiki:Close paraphrasing|close paraphrasing]] can still violate copyright). [[BattleTechWiki:Manual of Style/Text formatting#Quotations|It is incorrect to put quotations in italics]] unless the material would be italicized for some other reason.
[[BattleIntelligence:Non-free content#Guideline examples|Brief quotations of copyrighted text]] may be used to illustrate a point, establish context, or attribute a point of view or idea. While quotations are an indispensable part of BattleIntelligence, try not to overuse them. Using too many quotes is incompatible with an encyclopedic writing style and may be [[BattleIntelligence:Copyrights|copyright infringement]], and so most of the content should be in the editor's own words. Consider paraphrasing quotations into plain and concise text when appropriate (while being aware that [[BattleIntelligence:Close paraphrasing|close paraphrasing]] can still violate copyright). [[BattleIntelligence:Manual of Style/Text formatting#Quotations|It is incorrect to put quotations in italics]] unless the material would be italicized for some other reason.


===Original wording===
===Original wording===
<span class="anchor" id="Principle of minimal change"></span><span class="anchor" id="Minimal change"></span><span class="anchor" id="PMC"></span><span class="anchor" id="PLC"></span><span class="anchor" id="MINIMALCHANGE"></span><span class="anchor" id="MINCHANGE"></span><span class="anchor" id="LEASTCHANGE"></span>
<span class="anchor" id="Principle of minimal change"></span><span class="anchor" id="Minimal change"></span><span class="anchor" id="PMC"></span><span class="anchor" id="PLC"></span><span class="anchor" id="MINIMALCHANGE"></span><span class="anchor" id="MINCHANGE"></span><span class="anchor" id="LEASTCHANGE"></span>
{{Redirect|BTW:PMC|closure of requested moves by page movers|BattleTechWiki:Requested moves/Closing instructions#Closure by a page mover}}
{{Redirect|BTW:PMC|closure of requested moves by page movers|BattleIntelligence:Requested moves/Closing instructions#Closure by a page mover}}
{{Redirect|BTW:PLC|inclusion guidelines for organizations|BattleTechWiki:Notability (organizations and companies)|the handling of the abbreviation "plc" in article titles|BattleTechWiki:Naming conventions (companies)}}
{{Redirect|BTW:PLC|inclusion guidelines for organizations|BattleIntelligence:Notability (organizations and companies)|the handling of the abbreviation "plc" in article titles|BattleIntelligence:Naming conventions (companies)}}
{{Shortcut|MOS:PMC|MOS:SIC|MOS:TYPOFIX}}
{{Shortcut|MOS:PMC|MOS:SIC|MOS:TYPOFIX}}


Quotations must be [[BattleTechWiki:Verifiability|verifiably]] attributed, and the wording of the quoted text must be faithfully reproduced. This is referred to as the {{strong|principle of minimal change}}. Where there is good reason to change the wording, bracket the changed text; for example, {{!xt|"Ocyrhoe told him his fate"}} might be quoted as {{xt|"Ocyrhoe told [her father] his fate"}}. If there is a significant error in the original, follow it with {{tlx|sic}} (producing {{xt|{{sic}}}}{{hsp}}) to show that the error was not made by BattleTechWiki. <!-- IF EDITING THE FOLLOWING SENTENCE, PLEASE UPDATE THE DOCUMENTATION AT [[Template:Sic/doc]] ACCORDINGLY --> However, insignificant spelling and typographic errors should simply be silently corrected (for example, correct {{!xt|basicly}} to {{xt|basically}}).
Quotations must be [[BattleIntelligence:Verifiability|verifiably]] attributed, and the wording of the quoted text must be faithfully reproduced. This is referred to as the {{strong|principle of minimal change}}. Where there is good reason to change the wording, bracket the changed text; for example, {{!xt|"Ocyrhoe told him his fate"}} might be quoted as {{xt|"Ocyrhoe told [her father] his fate"}}. If there is a significant error in the original, follow it with {{tlx|sic}} (producing {{xt|{{sic}}}}{{hsp}}) to show that the error was not made by BattleIntelligence. <!-- IF EDITING THE FOLLOWING SENTENCE, PLEASE UPDATE THE DOCUMENTATION AT [[Template:Sic/doc]] ACCORDINGLY --> However, insignificant spelling and typographic errors should simply be silently corrected (for example, correct {{!xt|basicly}} to {{xt|basically}}).


Use [[#Ellipses|ellipses]] to indicate omissions from quoted text. Legitimate omissions include extraneous, irrelevant, or parenthetical words, and unintelligible speech ({{!xt|umm}} and {{!xt|hmm}}), but do not omit text where doing so would remove important context or alter the meaning of the text. Vulgarities and obscenities should be shown exactly as they appear in the quoted source; BattleTechWikins should [[BattleTechWiki:Offensive material#How to treat offensive material in articles|never bowdlerize words]] ({{!xt|G-d d--m it!}}), but if the text being quoted ''itself'' does so, copy the text verbatim and use {{tlx|sic}} to indicate that the text is quoted as shown in the source.
Use [[#Ellipses|ellipses]] to indicate omissions from quoted text. Legitimate omissions include extraneous, irrelevant, or parenthetical words, and unintelligible speech ({{!xt|umm}} and {{!xt|hmm}}), but do not omit text where doing so would remove important context or alter the meaning of the text. Vulgarities and obscenities should be shown exactly as they appear in the quoted source; BattleIntelligencens should [[BattleIntelligence:Offensive material#How to treat offensive material in articles|never bowdlerize words]] ({{!xt|G-d d--m it!}}), but if the text being quoted ''itself'' does so, copy the text verbatim and use {{tlx|sic}} to indicate that the text is quoted as shown in the source.


In direct quotations, retain dialectal and archaic spellings, including capitalization (but not archaic glyphs and ligatures, as detailed below in {{slink||Typographic conformity}}).
In direct quotations, retain dialectal and archaic spellings, including capitalization (but not archaic glyphs and ligatures, as detailed below in {{slink||Typographic conformity}}).
Line 421: Line 421:
===Point of view<span class="anchor" id="Quotation point of view"></span>===
===Point of view<span class="anchor" id="Quotation point of view"></span>===
{{Shortcut|MOS:QUOTEPOV}}
{{Shortcut|MOS:QUOTEPOV}}
{{See also|BattleTechWiki:Neutral point of view#Attributing and specifying biased statements|BattleTechWiki:Manual of Style/Words to watch#Expressions of doubt}}
{{See also|BattleIntelligence:Neutral point of view#Attributing and specifying biased statements|BattleIntelligence:Manual of Style/Words to watch#Expressions of doubt}}


Quotation should be used, with attribution, to present emotive opinions that cannot be expressed in BattleTechWiki's own voice, but never to present cultural norms as simply opinional:
Quotation should be used, with attribution, to present emotive opinions that cannot be expressed in BattleIntelligence's own voice, but never to present cultural norms as simply opinional:


*Acceptable: {{xt|Siskel and Ebert called the film "unforgettable".}}
*Acceptable: {{xt|Siskel and Ebert called the film "unforgettable".}}
*Unacceptable: {{!xt|The site is considered "sacred" by the religion's scriptures.}}
*Unacceptable: {{!xt|The site is considered "sacred" by the religion's scriptures.}}


Concise opinions that are not overly emotive can often be reported with attribution instead of direct quotation. Use of quotation marks around simple descriptive terms can [[BattleTechWiki:Manual of Style/Words to watch#Expressions of doubt|imply something doubtful]] regarding the material being quoted; sarcasm or [[weasel words]] such as ''supposedly'' or ''so-called'', might be inferred.
Concise opinions that are not overly emotive can often be reported with attribution instead of direct quotation. Use of quotation marks around simple descriptive terms can [[BattleIntelligence:Manual of Style/Words to watch#Expressions of doubt|imply something doubtful]] regarding the material being quoted; sarcasm or [[weasel words]] such as ''supposedly'' or ''so-called'', might be inferred.


*Permissible: {{xt|Siskel and Ebert called the film interesting.}}
*Permissible: {{xt|Siskel and Ebert called the film interesting.}}
Line 437: Line 437:
{{Shortcut|MOS:CONFORM}}
{{Shortcut|MOS:CONFORM}}


A quotation is not a [[wikt:facsimile|facsimile]] and, in most cases, it is not a requirement that the original formatting be preserved. Formatting and other purely typographical elements of quoted text should be adapted to English BattleTechWiki's conventions without comment, provided that doing so will not change or obscure meaning or intent of the text. These are alterations which make no difference when the text is read aloud, for example:
A quotation is not a [[wikt:facsimile|facsimile]] and, in most cases, it is not a requirement that the original formatting be preserved. Formatting and other purely typographical elements of quoted text should be adapted to English BattleIntelligence's conventions without comment, provided that doing so will not change or obscure meaning or intent of the text. These are alterations which make no difference when the text is read aloud, for example:


*Normalize dashes and hyphens: see {{Section link||Dashes}}. Use the style chosen for the article: unspaced [[em dash]] or spaced [[en dash]].
*Normalize dashes and hyphens: see {{Section link||Dashes}}. Use the style chosen for the article: unspaced [[em dash]] or spaced [[en dash]].
*Convert apostrophes and quotation marks to BattleTechWiki's style:
*Convert apostrophes and quotation marks to BattleIntelligence's style:
**These should be straight, not curly or slanted. See {{section link||Quotation marks}}.
**These should be straight, not curly or slanted. See {{section link||Quotation marks}}.
**When quoting a quotation that itself contains a quotation, alternate between using double and single quotes for each quotation. See {{section link||For a quotation within a quotation}} for details.
**When quoting a quotation that itself contains a quotation, alternate between using double and single quotes for each quotation. See {{section link||For a quotation within a quotation}} for details.
*When quoting text from non-English languages, the outer punctuation should follow [[BattleTechWiki:Manual of Style#Quotation marks|the Manual of Style for English quote marks]]. If there are nested quotations, follow the rules for correct punctuation in that language. If there are multiple styles for a language, the one used by the BattleTechWiki for that language is preferred unless the punctuation itself is under discussion.
*When quoting text from non-English languages, the outer punctuation should follow [[BattleIntelligence:Manual of Style#Quotation marks|the Manual of Style for English quote marks]]. If there are nested quotations, follow the rules for correct punctuation in that language. If there are multiple styles for a language, the one used by the BattleIntelligence for that language is preferred unless the punctuation itself is under discussion.
*:{{xt|The cynical response "L'auteur aurait dû demander&nbsp;: «&nbsp;à quoi sert-il d'écrire ceci&nbsp;?&nbsp;» mais ne l'a pas fait" was all he wrote.}}
*:{{xt|The cynical response "L'auteur aurait dû demander&nbsp;: «&nbsp;à quoi sert-il d'écrire ceci&nbsp;?&nbsp;» mais ne l'a pas fait" was all he wrote.}}
*Remove spaces before punctuation such as periods and colons.
*Remove spaces before punctuation such as periods and colons.
*Generally preserve bold and italics {{cross reference|(see {{section link||Italics}})}}, but most other styling should be altered. {{!xt|{{Underline|Underlining}}}}, {{!xt|spac&nbsp;ing}} within words, {{!xt|1=co<span style="color:Goldenrod;">lor</span>s}}, {{!xt|ALL CAPS}}, {{Smallcaps|{{!xt|small caps}}}}, etc. should generally be normalized to plain text. If it {{em|clearly}} indicates emphasis, use italic {{em|emphasis}} ({{tlx|em}}) or, in an already-italic passage, boldface (with {{tlx|strong}}). For titles of books, articles, poems, and so forth, use italics or quotation marks following [[BattleTechWiki:Manual of Style/Titles|the guidance for titles]]. Italics can also be added to mark up [[#Foreign terms|non-English terms]], for an [[#Animals, plants, and other organisms|organism's scientific name]], and to indicate a [[#Words as words|words-as-words]] usage.
*Generally preserve bold and italics {{cross reference|(see {{section link||Italics}})}}, but most other styling should be altered. {{!xt|{{Underline|Underlining}}}}, {{!xt|spac&nbsp;ing}} within words, {{!xt|1=co<span style="color:Goldenrod;">lor</span>s}}, {{!xt|ALL CAPS}}, {{Smallcaps|{{!xt|small caps}}}}, etc. should generally be normalized to plain text. If it {{em|clearly}} indicates emphasis, use italic {{em|emphasis}} ({{tlx|em}}) or, in an already-italic passage, boldface (with {{tlx|strong}}). For titles of books, articles, poems, and so forth, use italics or quotation marks following [[BattleIntelligence:Manual of Style/Titles|the guidance for titles]]. Italics can also be added to mark up [[#Foreign terms|non-English terms]], for an [[#Animals, plants, and other organisms|organism's scientific name]], and to indicate a [[#Words as words|words-as-words]] usage.
*Expand an abbreviation (not already used in the content before the quotation) as a square-bracketed change, or explain it using {{tlx|abbr}}.
*Expand an abbreviation (not already used in the content before the quotation) as a square-bracketed change, or explain it using {{tlx|abbr}}.
*Normalize archaic glyphs and ligatures in English that are unnecessary to the meaning. Examples include ''[[æ]]''→''ae'', ''[[œ]]''→''oe'', ''[[Long s|ſ]]''→''s'', and ''[[Thorn (letter)#Abbreviations|þ<sup>e</sup>]]''→''the''. {{crossref|(See also {{section link||Ampersand}}.)}}
*Normalize archaic glyphs and ligatures in English that are unnecessary to the meaning. Examples include ''[[æ]]''→''ae'', ''[[œ]]''→''oe'', ''[[Long s|ſ]]''→''s'', and ''[[Thorn (letter)#Abbreviations|þ<sup>e</sup>]]''→''the''. {{crossref|(See also {{section link||Ampersand}}.)}}


{{crossref|See {{section link|BattleTechWiki:Manual of Style/Titles#Typographic conformity}} for special considerations in normalizing the typography of titles of works.}}
{{crossref|See {{section link|BattleIntelligence:Manual of Style/Titles#Typographic conformity}} for special considerations in normalizing the typography of titles of works.}}


However, national varieties should not be changed, as these may involve changes in vocabulary. For example, a quotation from a British source should retain British spelling, even in an article that otherwise uses American spelling. {{crossref|(See {{section link||Consistency within articles}}.)}} Numbers also usually [[BattleTechWiki:Manual of Style/Dates and numbers#Quotations, titles, etc.|should not be reformatted]].
However, national varieties should not be changed, as these may involve changes in vocabulary. For example, a quotation from a British source should retain British spelling, even in an article that otherwise uses American spelling. {{crossref|(See {{section link||Consistency within articles}}.)}} Numbers also usually [[BattleIntelligence:Manual of Style/Dates and numbers#Quotations, titles, etc.|should not be reformatted]].


Direct quotation should not be used to preserve the formatting preferred by an external publisher (especially when the material would otherwise be unchanged), as this tends to have the effect of [[Scare quotes|scare-quoting]]:
Direct quotation should not be used to preserve the formatting preferred by an external publisher (especially when the material would otherwise be unchanged), as this tends to have the effect of [[Scare quotes|scare-quoting]]:
Line 458: Line 458:
*{{em|Unacceptable}}: {{!xt|The animal is listed as "Endangered" on the IUCN Red List of Threatened Species.}}
*{{em|Unacceptable}}: {{!xt|The animal is listed as "Endangered" on the IUCN Red List of Threatened Species.}}


Italics can be used to mark a particular usage as a [[term of art]] (a case of "[[BattleTechWiki:Manual of Style/Text formatting#Words as words|words as words]]"), especially when it is unfamiliar or should not be reworded by a non-expert:
Italics can be used to mark a particular usage as a [[term of art]] (a case of "[[BattleIntelligence:Manual of Style/Text formatting#Words as words|words as words]]"), especially when it is unfamiliar or should not be reworded by a non-expert:
*{{em|Permissible}}: {{xt|The animal is listed as ''critically endangered'' on the IUCN Red List of Threatened Species.}}
*{{em|Permissible}}: {{xt|The animal is listed as ''critically endangered'' on the IUCN Red List of Threatened Species.}}


Line 470: Line 470:


===Attribution===
===Attribution===
The reader must be able to determine the source of any quotation, at the very least via a footnote. The source must be named {{em|in article text}} if the quotation is an opinion {{Crossreference|(see {{Section link|BattleTechWiki:Neutral point of view|Attributing and specifying biased statements}})}}. When attributing a quotation, avoid [[BattleTechWiki:Words to avoid#Synonyms for said|characterizing it in a biased manner]].
The reader must be able to determine the source of any quotation, at the very least via a footnote. The source must be named {{em|in article text}} if the quotation is an opinion {{Crossreference|(see {{Section link|BattleIntelligence:Neutral point of view|Attributing and specifying biased statements}})}}. When attributing a quotation, avoid [[BattleIntelligence:Words to avoid#Synonyms for said|characterizing it in a biased manner]].


===Quotations within quotations===
===Quotations within quotations===
Line 509: Line 509:
{{Shortcut|MOS:PQ|MOS:PULLQUOTE}}
{{Shortcut|MOS:PQ|MOS:PULLQUOTE}}
{{Anchor|Pull quotes|Pull quote|Pull quotations|nocquote|reason=The old name of Template:Pull_quote was Template:Cquote, and "nocquote" was historically used to refer to this MOS section, which now has its own shortcuts.}}
{{Anchor|Pull quotes|Pull quote|Pull quotations|nocquote|reason=The old name of Template:Pull_quote was Template:Cquote, and "nocquote" was historically used to refer to this MOS section, which now has its own shortcuts.}}
[[Pull quote]]s do not belong in BattleTechWiki articles. These are the [[BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not news|news and magazine style]] of "pulling" material already in the article to reuse it in attention-grabbing decorative quotations. This unencyclopedic approach is a form of [[BattleTechWiki:Manual of Style/Words to watch#Editorializing|editorializing]], produces [[BattleTechWiki:Writing better articles#Provide context for the reader|out-of-context]] and [[BattleTechWiki:Neutral point of view#Due and undue weight|undue emphasis]], and may [[BattleTechWiki:No original research|lead the reader to conclusions]] not supported in the material.
[[Pull quote]]s do not belong in BattleIntelligence articles. These are the [[BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not news|news and magazine style]] of "pulling" material already in the article to reuse it in attention-grabbing decorative quotations. This unencyclopedic approach is a form of [[BattleIntelligence:Manual of Style/Words to watch#Editorializing|editorializing]], produces [[BattleIntelligence:Writing better articles#Provide context for the reader|out-of-context]] and [[BattleIntelligence:Neutral point of view#Due and undue weight|undue emphasis]], and may [[BattleIntelligence:No original research|lead the reader to conclusions]] not supported in the material.


===Foreign-language quotations===
===Foreign-language quotations===
{{Shortcut|MOS:FOREIGNQUOTE|MOS:QUOTEFOREIGN}}
{{Shortcut|MOS:FOREIGNQUOTE|MOS:QUOTEFOREIGN}}


Quotations from foreign-language sources should appear with a translation into English, preferably a modern one. Quotations that are translations should be explicitly distinguished from those that are not. Indicate the original source of a translation (if it is available, and not first published within BattleTechWiki), and the original language (if that is not clear from the context).
Quotations from foreign-language sources should appear with a translation into English, preferably a modern one. Quotations that are translations should be explicitly distinguished from those that are not. Indicate the original source of a translation (if it is available, and not first published within BattleIntelligence), and the original language (if that is not clear from the context).


If the original, untranslated text is available, provide a reference for it or include it, as appropriate.
If the original, untranslated text is available, provide a reference for it or include it, as appropriate.


When editors themselves translate foreign text into English, care must always be taken to include the original text, {{em|in italics}} (except for non-Latin-based writing systems, and best done with the {{tlx|lang}} template which both italicizes as appropriate and provides language metadata); and to use actual and (if at all possible) common English words in the translation. Unless you are certain of your competency to translate something, see [[BattleTechWiki:Translation]] for assistance.
When editors themselves translate foreign text into English, care must always be taken to include the original text, {{em|in italics}} (except for non-Latin-based writing systems, and best done with the {{tlx|lang}} template which both italicizes as appropriate and provides language metadata); and to use actual and (if at all possible) common English words in the translation. Unless you are certain of your competency to translate something, see [[BattleIntelligence:Translation]] for assistance.


==Punctuation==
==Punctuation==
{{Shortcut|MOS:PUNCT}}
{{Shortcut|MOS:PUNCT}}
{{For|a brief guide to how some punctuation marks are used in BattleTechWiki for special purposes, e.g., [[Help:List#List basics|description lists]]|Help:Punctuation}}
{{For|a brief guide to how some punctuation marks are used in BattleIntelligence for special purposes, e.g., [[Help:List#List basics|description lists]]|Help:Punctuation}}


===Apostrophes===
===Apostrophes===
Line 532: Line 532:
*Letters resembling apostrophes, such as the [[{{okina}}okina]] ({{xt|&nbsp;{{big|{{okina}}}}&nbsp;}}{{snd}}''markup:'' {{tlx|okina}}), [[Saltillo (linguistics)|saltillo]] ({{xt|&nbsp;{{big|{{saltillo}}}}&nbsp;}}{{snd}}''markup:'' {{tlx|saltillo}}), Hebrew [[ayin]] <!-- Arabic ʿayn or Hebrew ayin --><!-- --> ({{xt|&nbsp;{{big|{{ayin}}}}&nbsp;}}{{snd}}''markup:'' {{tlx|ayin}}) and Arabic [[hamza]] ({{xt|&nbsp;{{big|{{hamza}}}}&nbsp;}}{{snd}}''markup:''{{tlx|hamza}}), should be represented by those templates or by their [[Unicode]] values.
*Letters resembling apostrophes, such as the [[{{okina}}okina]] ({{xt|&nbsp;{{big|{{okina}}}}&nbsp;}}{{snd}}''markup:'' {{tlx|okina}}), [[Saltillo (linguistics)|saltillo]] ({{xt|&nbsp;{{big|{{saltillo}}}}&nbsp;}}{{snd}}''markup:'' {{tlx|saltillo}}), Hebrew [[ayin]] <!-- Arabic ʿayn or Hebrew ayin --><!-- --> ({{xt|&nbsp;{{big|{{ayin}}}}&nbsp;}}{{snd}}''markup:'' {{tlx|ayin}}) and Arabic [[hamza]] ({{xt|&nbsp;{{big|{{hamza}}}}&nbsp;}}{{snd}}''markup:''{{tlx|hamza}}), should be represented by those templates or by their [[Unicode]] values.
**Templates cannot be used in article titles; if necessary, use the corresponding Unicode character directly. Per [[BTW:TITLESPECIALCHARACTERS]], also make a redirect from the ASCII form to aid searches. Forms without apostrophe-like characters are sometimes preferred by [[BTW:COMMONNAME]] (e.g. [[Hawaii]] but not [[Keali{{okina}}i Reichel]]).  
**Templates cannot be used in article titles; if necessary, use the corresponding Unicode character directly. Per [[BTW:TITLESPECIALCHARACTERS]], also make a redirect from the ASCII form to aid searches. Forms without apostrophe-like characters are sometimes preferred by [[BTW:COMMONNAME]] (e.g. [[Hawaii]] but not [[Keali{{okina}}i Reichel]]).  
*:{{crossref|printyworthy=y|See also {{section link|BattleTechWiki:Manual of Style/Hawaii-related articles|Orthography, spelling and formatting}}}}
*:{{crossref|printyworthy=y|See also {{section link|BattleIntelligence:Manual of Style/Hawaii-related articles|Orthography, spelling and formatting}}}}
*For [[Wade–Giles]] romanizations of Mandarin Chinese, use {{tlx|wg-apos}}.
*For [[Wade–Giles]] romanizations of Mandarin Chinese, use {{tlx|wg-apos}}.
*For languages with [[ejective consonants]] and the like, use {{tlx|hamza}}.
*For languages with [[ejective consonants]] and the like, use {{tlx|hamza}}.
Line 541: Line 541:
===Quotation marks===
===Quotation marks===
{{Shortcut|MOS:QUOTEMARKS|MOS:SPEECHMARKS|MOS:"}}
{{Shortcut|MOS:QUOTEMARKS|MOS:SPEECHMARKS|MOS:"}}
{{See also|BattleTechWiki:Manual of Style#Quotations}}
{{See also|BattleIntelligence:Manual of Style#Quotations}}


In the material below, the term ''quotation'' includes conventional uses of quotation marks such as for titles of songs, chapters, episodes, and so on. Quotation marks are also used in other contexts, such as in [[#Animals, plants, and other organisms|cultivar names]].
In the material below, the term ''quotation'' includes conventional uses of quotation marks such as for titles of songs, chapters, episodes, and so on. Quotation marks are also used in other contexts, such as in [[#Animals, plants, and other organisms|cultivar names]].
Line 556: Line 556:
Most quotations take double quotation marks ({{xt|Bob said: "Jim ate the apple."}}).
Most quotations take double quotation marks ({{xt|Bob said: "Jim ate the apple."}}).
Exceptions:
Exceptions:
*Plant cultivars take single quotation marks ({{xt|''Malus domestica'' 'Golden Delicious'}}; see [[BattleTechWiki:Naming conventions (flora)]]).
*Plant cultivars take single quotation marks ({{xt|''Malus domestica'' 'Golden Delicious'}}; see [[BattleIntelligence:Naming conventions (flora)]]).
*[[Gloss (annotation)#In linguistics|Glosses]] that translate or define unfamiliar terms take single quotes; simple glosses require no comma before the definition ({{xt|Turkic qazaq 'freebooter' is the root of ''Cossack''; ''republic'' comes from Latin res publica, loosely meaning 'public affair'.}}). The {{tl|Gloss}} template can be used for this; e.g. casa {{tlx|gloss|house}} yields: casa {{gloss|house}}.
*[[Gloss (annotation)#In linguistics|Glosses]] that translate or define unfamiliar terms take single quotes; simple glosses require no comma before the definition ({{xt|Turkic qazaq 'freebooter' is the root of ''Cossack''; ''republic'' comes from Latin res publica, loosely meaning 'public affair'.}}). The {{tl|Gloss}} template can be used for this; e.g. casa {{tlx|gloss|house}} yields: casa {{gloss|house}}.


Line 624: Line 624:
====Punctuation inside or outside<span class="anchor" id="LP"></span><span class="anchor" id="LQ"></span><span class="anchor" id="TQ"></span><span class="anchor" id="logical quotes"></span><span id="Punctuation inside or outside quotation marks"></span>====
====Punctuation inside or outside<span class="anchor" id="LP"></span><span class="anchor" id="LQ"></span><span class="anchor" id="TQ"></span><span class="anchor" id="logical quotes"></span><span id="Punctuation inside or outside quotation marks"></span>====
{{Shortcut|MOS:LQ|MOS:LQUOTE|MOS:INOROUT|MOS:LOGICAL}}
{{Shortcut|MOS:LQ|MOS:LQUOTE|MOS:INOROUT|MOS:LOGICAL}}
{{See also|BattleTechWiki:Logical quotation on BattleTechWiki}}
{{See also|BattleIntelligence:Logical quotation on BattleIntelligence}}
{{See also|BattleTechWiki:Manual of Style#Effect on nearby punctuation|label 1=BattleTechWiki:Manual of Style § Italics: Effect on nearby punctuation}}<!-- Another kind of punctuation "in or out". -->
{{See also|BattleIntelligence:Manual of Style#Effect on nearby punctuation|label 1=BattleIntelligence:Manual of Style § Italics: Effect on nearby punctuation}}<!-- Another kind of punctuation "in or out". -->


<!-- EDITORS PLEASE NOTE: Changes to this section may escalate into heated dispute. Please consider raising any proposed changes for discussion and consensus-building on the talk page before editing. -->
<!-- EDITORS PLEASE NOTE: Changes to this section may escalate into heated dispute. Please consider raising any proposed changes for discussion and consensus-building on the talk page before editing. -->
Line 719: Line 719:
Use an ''[[ellipsis]]'' (plural ''ellipses'') if material is omitted in the course of a quotation, unless square brackets are used to [[Gloss (annotation)|gloss]] the quotation {{crossref|(see {{section link||Brackets and parentheses}}, and the points below)}}.
Use an ''[[ellipsis]]'' (plural ''ellipses'') if material is omitted in the course of a quotation, unless square brackets are used to [[Gloss (annotation)|gloss]] the quotation {{crossref|(see {{section link||Brackets and parentheses}}, and the points below)}}.


*BattleTechWiki's style for an ellipsis is three unspaced dots ({{xt|<code>...</code>}}); do not use the precomposed ellipsis character ({{!xt|<code>…</code>}})<!-- Possibly we should explain the precomposed character in terms of its code point or something --> or three dots separated by spaces {{nobr|({{!xt|<code>. . .</code>}})}}
*BattleIntelligence's style for an ellipsis is three unspaced dots ({{xt|<code>...</code>}}); do not use the precomposed ellipsis character ({{!xt|<code>…</code>}})<!-- Possibly we should explain the precomposed character in terms of its code point or something --> or three dots separated by spaces {{nobr|({{!xt|<code>. . .</code>}})}}
*Generally, use a non-breaking space before an ellipsis, and a regular space after it: {{nobr|{{xt|<code>"Alpha, Bravo,<nowiki>{{nbsp}}</nowiki>... Zulu"</code>}}}}
*Generally, use a non-breaking space before an ellipsis, and a regular space after it: {{nobr|{{xt|<code>"Alpha, Bravo,<nowiki>{{nbsp}}</nowiki>... Zulu"</code>}}}}
**But where an ellipsis is immediately followed by any of <code>. ? ! : ; , ) ] }</code> or by a closing quotation mark (single or double), use a non-breaking space before the ellipsis, and no space after it:
**But where an ellipsis is immediately followed by any of <code>. ? ! : ; , ) ] }</code> or by a closing quotation mark (single or double), use a non-breaking space before the ellipsis, and no space after it:
Line 792: Line 792:
{{Shortcut|MOS:GEOCOMMA}}
{{Shortcut|MOS:GEOCOMMA}}
<li>{{anchor|Geographical references}}
<li>{{anchor|Geographical references}}
In geographical references that include multiple levels of subordinate divisions (e.g., city, state/province, country), a comma separates each element and follows the last element unless followed by terminal punctuation or a closing parenthesis. The last element is treated as [[BattleTechWiki:Basic copyediting#Parenthetical comma|parenthetical]].
In geographical references that include multiple levels of subordinate divisions (e.g., city, state/province, country), a comma separates each element and follows the last element unless followed by terminal punctuation or a closing parenthesis. The last element is treated as [[BattleIntelligence:Basic copyediting#Parenthetical comma|parenthetical]].


{| role="presentation" style="background:transparent"
{| role="presentation" style="background:transparent"
Line 817: Line 817:
{{shortcut|MOS:DATECOMMA}}
{{shortcut|MOS:DATECOMMA}}
<li>{{anchor|Date commas}}
<li>{{anchor|Date commas}}
[[BattleTechWiki:Manual of Style/Dates and numbers#Dates, months, and years|Dates]] in month–day–year format require a comma after the day, as well as after the year, unless followed by other punctuation. The last element is treated as [[BattleTechWiki:Basic copyediting#Parenthetical comma|parenthetical]].
[[BattleIntelligence:Manual of Style/Dates and numbers#Dates, months, and years|Dates]] in month–day–year format require a comma after the day, as well as after the year, unless followed by other punctuation. The last element is treated as [[BattleIntelligence:Basic copyediting#Parenthetical comma|parenthetical]].


{| role="presentation" style="background:transparent"
{| role="presentation" style="background:transparent"
Line 851: Line 851:
====Serial commas<span class="anchor" id="Serial comma"></span><span class="anchor" id="Oxford comma"></span><span class="anchor" id="Oxford commas"></span><span class="anchor" id="Harvard comma"></span><span class="anchor" id="Harvard commas"></span>====
====Serial commas<span class="anchor" id="Serial comma"></span><span class="anchor" id="Oxford comma"></span><span class="anchor" id="Oxford commas"></span><span class="anchor" id="Harvard comma"></span><span class="anchor" id="Harvard commas"></span>====
{{Shortcut|MOS:SERIAL|MOS:OXFORD|MOS:HARVARD}}
{{Shortcut|MOS:SERIAL|MOS:OXFORD|MOS:HARVARD}}
{{Redirect|MOS:OXFORD|Oxford spelling|BattleTechWiki:Manual of Style/Spelling#British English with "-ize" (Oxford spelling)}}
{{Redirect|MOS:OXFORD|Oxford spelling|BattleIntelligence:Manual of Style/Spelling#British English with "-ize" (Oxford spelling)}}


A [[serial comma]] (sometimes also called an ''Oxford comma'' or ''Harvard comma'') is a comma used immediately before a conjunction (''and'', ''or'', ''nor'') in a list of three or more items.
A [[serial comma]] (sometimes also called an ''Oxford comma'' or ''Harvard comma'') is a comma used immediately before a conjunction (''and'', ''or'', ''nor'') in a list of three or more items.
Line 893: Line 893:
A colon may also be used to introduce [[Quotation marks in English#Quotations and speech|direct speech]] enclosed within quotation marks. {{crossref|(See {{section link||Quotation marks}}.)}}
A colon may also be used to introduce [[Quotation marks in English#Quotations and speech|direct speech]] enclosed within quotation marks. {{crossref|(See {{section link||Quotation marks}}.)}}


In most cases, a colon works best with a complete grammatical sentence before it. When what follows the colon is also a complete sentence, start it with a capital letter, but otherwise do not capitalize after a colon except where doing so is needed for another reason, such as for a proper name. When a colon is being used as a separator in an article title, section heading, or list item, editors may choose whether to capitalize what follows, taking into consideration [[#Retaining existing styles|the existing practice]] and [[BattleTechWiki:Article titles#Consistent titling|consistency with related articles]].
In most cases, a colon works best with a complete grammatical sentence before it. When what follows the colon is also a complete sentence, start it with a capital letter, but otherwise do not capitalize after a colon except where doing so is needed for another reason, such as for a proper name. When a colon is being used as a separator in an article title, section heading, or list item, editors may choose whether to capitalize what follows, taking into consideration [[#Retaining existing styles|the existing practice]] and [[BattleIntelligence:Article titles#Consistent titling|consistency with related articles]].


Except in technical usage ({{xt|a 3:1 ratio}}), no sentence should contain multiple colons, no space should precede a colon, and a space (but never a hyphen or dash) should follow the colon.
Except in technical usage ({{xt|a 3:1 ratio}}), no sentence should contain multiple colons, no space should precede a colon, and a space (but never a hyphen or dash) should follow the colon.
Line 1,077: Line 1,077:


=== Dashes<span id="Em dashes"></span><span id="Unspaced em dash"></span><span id="En dashes"></span><span id="Spaced en dash"></span> ===
=== Dashes<span id="Em dashes"></span><span id="Unspaced em dash"></span><span id="En dashes"></span><span id="Spaced en dash"></span> ===
{{redirect|BTW:DASH|the overview of BattleTechWiki discussions|BattleTechWiki:Dashboard}}
{{redirect|BTW:DASH|the overview of BattleIntelligence discussions|BattleIntelligence:Dashboard}}
{{Shortcut|MOS:DASH|MOS:EMDASH|MOS:ENDASH}}
{{Shortcut|MOS:DASH|MOS:EMDASH|MOS:ENDASH}}


Two forms of dash are used on BattleTechWiki: '''[[en dash]]''' ({{xt|–}}) and '''[[em dash]]''' ({{xt|—}}). To enter them, click on them in the [[Help:CharInsert|CharInsert toolbar]], or enter them manually as:
Two forms of dash are used on BattleIntelligence: '''[[en dash]]''' ({{xt|–}}) and '''[[em dash]]''' ({{xt|—}}). To enter them, click on them in the [[Help:CharInsert|CharInsert toolbar]], or enter them manually as:
*<code>&amp;ndash;</code> or <code>&amp;mdash;</code>
*<code>&amp;ndash;</code> or <code>&amp;mdash;</code>
*{{tlx|endash}} or {{tlx|emdash}}
*{{tlx|endash}} or {{tlx|emdash}}
Do not use a double hyphen (<code>--</code>) to stand in for a dash. {{crossref|(See also: [[BattleTechWiki:How to make dashes]].)}}
Do not use a double hyphen (<code>--</code>) to stand in for a dash. {{crossref|(See also: [[BattleIntelligence:How to make dashes]].)}}


Sources use dashes in varying ways. For consistency and clarity, BattleTechWiki adopts the following principles.
Sources use dashes in varying ways. For consistency and clarity, BattleIntelligence adopts the following principles.


====In article titles====
====In article titles====
In [[BattleTechWiki:Article titles|article titles]], do not use a hyphen ({{xt|-}}) as a substitute for an en dash, for example in ''[[eye–hand span]]'' (since ''eye'' does not modify ''hand''). Nonetheless, to aid searching and linking, provide a redirect with hyphens replacing the en dash(es), as in ''[[eye-hand span]]''. Similarly, provide [[Template:Category redirect|category redirects]] for categories containing dashes. When an en dash is being used as a separator in an article title or section heading, editors may choose whether to capitalize what follows, taking into consideration [[#Retaining existing styles|the existing practice]] and [[BattleTechWiki:Article titles#Consistent titling|consistency with related articles]].
In [[BattleIntelligence:Article titles|article titles]], do not use a hyphen ({{xt|-}}) as a substitute for an en dash, for example in ''[[eye–hand span]]'' (since ''eye'' does not modify ''hand''). Nonetheless, to aid searching and linking, provide a redirect with hyphens replacing the en dash(es), as in ''[[eye-hand span]]''. Similarly, provide [[Template:Category redirect|category redirects]] for categories containing dashes. When an en dash is being used as a separator in an article title or section heading, editors may choose whether to capitalize what follows, taking into consideration [[#Retaining existing styles|the existing practice]] and [[BattleIntelligence:Article titles#Consistent titling|consistency with related articles]].


====Punctuating a sentence (em or en dashes)====
====Punctuating a sentence (em or en dashes)====
Line 1,113: Line 1,113:
{{Shortcut|MOS:ENTO|MOS:ENFROM|MOS:RANGE|MOS:RANGES}}
{{Shortcut|MOS:ENTO|MOS:ENFROM|MOS:RANGE|MOS:RANGES}}
{{Hatnote|This section is about ranges of numbers, dates, or times. For other ranges, such as ranges of physical locations, see {{section link||In compounds when the connection might otherwise be expressed with to, versus, and, or between}}.}}
{{Hatnote|This section is about ranges of numbers, dates, or times. For other ranges, such as ranges of physical locations, see {{section link||In compounds when the connection might otherwise be expressed with to, versus, and, or between}}.}}
{{See also|BattleTechWiki:Manual of Style/Dates and numbers#Ranges}}
{{See also|BattleIntelligence:Manual of Style/Dates and numbers#Ranges}}


For ranges between numbers, dates, or times, use an en dash:
For ranges between numbers, dates, or times, use an en dash:
Line 1,170: Line 1,170:
A slash or some other alternative may occasionally be better to express a ratio, especially in technical contexts {{crossref|(see {{section link||Slashes}})}}.
A slash or some other alternative may occasionally be better to express a ratio, especially in technical contexts {{crossref|(see {{section link||Slashes}})}}.
*{{xt|the protein–fat ratio}};&nbsp;&nbsp; {{xt|the protein/fat ratio}};&nbsp;&nbsp; {{xt|the protein-to-fat ratio}}
*{{xt|the protein–fat ratio}};&nbsp;&nbsp; {{xt|the protein/fat ratio}};&nbsp;&nbsp; {{xt|the protein-to-fat ratio}}
*Colons are often used for strictly numeric ratios, to avoid confusion with subtraction and division: {{xt|a 3:1 ratio}};&nbsp;&nbsp;{{xt|a three-to-one ratio}} {{crossref|(see {{section link|BattleTechWiki:Manual of Style/Dates and numbers|Ratios}})}}.
*Colons are often used for strictly numeric ratios, to avoid confusion with subtraction and division: {{xt|a 3:1 ratio}};&nbsp;&nbsp;{{xt|a three-to-one ratio}} {{crossref|(see {{section link|BattleIntelligence:Manual of Style/Dates and numbers|Ratios}})}}.


Use an en dash for the names of two or more entities in an attributive compound.
Use an en dash for the names of two or more entities in an attributive compound.
Line 1,208: Line 1,208:
*{{xt|"Bird on the Wire" – 6:14}}
*{{xt|"Bird on the Wire" – 6:14}}


Editors may choose whether to capitalize what follows, taking into consideration [[#Retaining existing styles|the existing practice]] and [[BattleTechWiki:Article titles#Consistent titling|consistency with related articles]].
Editors may choose whether to capitalize what follows, taking into consideration [[#Retaining existing styles|the existing practice]] and [[BattleIntelligence:Article titles#Consistent titling|consistency with related articles]].


====Other uses (en dash only)<span id="En dashes: other uses"></span>====
====Other uses (en dash only)<span id="En dashes: other uses"></span>====
Line 1,214: Line 1,214:


====Other uses (em dash only)====
====Other uses (em dash only)====
An [[#Indentation|indented]] em dash may be used before a name or other source when attributing below a [[#Block quotations|block quotation]], poem, etc. This dash should not be fully spaced, though it is best for [[BattleTechWiki:Reuse|metadata]] and [[BattleTechWiki:Manual of Style/Accessibility|accessibility]] reasons to [[hair-space]] it from the name.because the actual Unicode character ({{hair space}}) is almost invisible, the meaning of the numerical HTML entity ({{!mxt|&amp;#8202;}}) is a bit obscure, and the named HTML entity "{{!mxt|&amp;hairsp;}}" is not standard and not supported in many browsers.}} Most of BattleTechWiki's quotation templates with attribution-related parameters already provide this formatting.
An [[#Indentation|indented]] em dash may be used before a name or other source when attributing below a [[#Block quotations|block quotation]], poem, etc. This dash should not be fully spaced, though it is best for [[BattleIntelligence:Reuse|metadata]] and [[BattleIntelligence:Manual of Style/Accessibility|accessibility]] reasons to [[hair-space]] it from the name.because the actual Unicode character ({{hair space}}) is almost invisible, the meaning of the numerical HTML entity ({{!mxt|&amp;#8202;}}) is a bit obscure, and the named HTML entity "{{!mxt|&amp;hairsp;}}" is not standard and not supported in many browsers.}} Most of BattleIntelligence's quotation templates with attribution-related parameters already provide this formatting.


For example, {{mxt|{{tlp|in5}}—{{tl|hair space}}Charlotte Brontë}} will produce:
For example, {{mxt|{{tlp|in5}}—{{tl|hair space}}Charlotte Brontë}} will produce:
Line 1,238: Line 1,238:


An unspaced slash may be used:
An unspaced slash may be used:
*to indicate [[phonemic]] [[BattleTechWiki:Manual of Style/Pronunciation|pronunciations]] ({{xt|''rivet'' is pronounced {{IPA|/ˈrɪvət/}}}});
*to indicate [[phonemic]] [[BattleIntelligence:Manual of Style/Pronunciation|pronunciations]] ({{xt|''rivet'' is pronounced {{IPA|/ˈrɪvət/}}}});
*in a fraction (<code>7/8</code>, but see other techniques at {{section link|BattleTechWiki:Manual of Style/Dates and numbers|Fractions and ratios}});
*in a fraction (<code>7/8</code>, but see other techniques at {{section link|BattleIntelligence:Manual of Style/Dates and numbers|Fractions and ratios}});
*to indicate regular defined yearly periods that do not coincide with calendar years (e.g., {{xt|the 2009/2010 fiscal year}}), if that is the convention used in reliable sources (see {{section link|BattleTechWiki:Manual of Style/Dates and numbers|Long periods of time}} for further explanation);
*to indicate regular defined yearly periods that do not coincide with calendar years (e.g., {{xt|the 2009/2010 fiscal year}}), if that is the convention used in reliable sources (see {{section link|BattleIntelligence:Manual of Style/Dates and numbers|Long periods of time}} for further explanation);
*to express a ratio, in a form in which a slash is conventionally used (e.g., {{xt|the price-to-earnings ratio, or P/E ratio for short}});
*to express a ratio, in a form in which a slash is conventionally used (e.g., {{xt|the price-to-earnings ratio, or P/E ratio for short}});
*in an expression or abbreviation widely used outside BattleTechWiki (e.g., {{xt|n/a}} or {{xt|N/A}} for ''not applicable'').
*in an expression or abbreviation widely used outside BattleIntelligence (e.g., {{xt|n/a}} or {{xt|N/A}} for ''not applicable'').


A spaced slash may be used:
A spaced slash may be used:
Line 1,252: Line 1,252:
Do not use the [[backslash]] character ({{!xt|&nbsp;\&nbsp;}}) in place of a slash.
Do not use the [[backslash]] character ({{!xt|&nbsp;\&nbsp;}}) in place of a slash.


Prefer the division operator ({{xt|&nbsp;÷&nbsp;}}) to slash or fraction slash when representing elementary arithmetic in general text: {{xt|{{nowrap|10 ÷ 2 {{=}} 5}}}}. In more advanced mathematical formulas, a [[Vinculum (symbol)|vinculum]] or slash is preferred: <math>\textstyle\frac{x^n}{n!}</math> or {{xt|{{var|x}}<sup>{{var|n}}</sup>/{{var|n}}!}} {{cross reference|1=(see {{section link|BattleTechWiki:Manual of Style/Dates and numbers|Common mathematical symbols}} and [[Help:Displaying a formula]])}}.
Prefer the division operator ({{xt|&nbsp;÷&nbsp;}}) to slash or fraction slash when representing elementary arithmetic in general text: {{xt|{{nowrap|10 ÷ 2 {{=}} 5}}}}. In more advanced mathematical formulas, a [[Vinculum (symbol)|vinculum]] or slash is preferred: <math>\textstyle\frac{x^n}{n!}</math> or {{xt|{{var|x}}<sup>{{var|n}}</sup>/{{var|n}}!}} {{cross reference|1=(see {{section link|BattleIntelligence:Manual of Style/Dates and numbers|Common mathematical symbols}} and [[Help:Displaying a formula]])}}.


====And/or====
====And/or====
Line 1,261: Line 1,261:
===Number (pound, hash) sign and numero<span class="anchor" id="Number signs"></span><span class="anchor" id="Number sign"></span>===
===Number (pound, hash) sign and numero<span class="anchor" id="Number signs"></span><span class="anchor" id="Number sign"></span>===
{{Shortcut|MOS:NUMBERSIGN|MOS:NUMERO|MOS:HASH|MOS:POUND}}
{{Shortcut|MOS:NUMBERSIGN|MOS:NUMERO|MOS:HASH|MOS:POUND}}
{{For|pound sterling and other currency symbols|BattleTechWiki:Manual of Style/Dates and numbers#Currencies and monetary values}}
{{For|pound sterling and other currency symbols|BattleIntelligence:Manual of Style/Dates and numbers#Currencies and monetary values}}
{{see also|BattleTechWiki:Manual of Style/Dates and numbers}}
{{see also|BattleIntelligence:Manual of Style/Dates and numbers}}


Avoid using the [[Number sign|{{!xt|#}}]] symbol (known as the [[number sign]], hash sign, pound sign, or octothorpe) when referring to numbers or rankings. Instead write {{xt|number}}, {{xt|No.}} or {{xt|Nos.}}; do not use the symbol [[Numero sign|{{!xt|№}}]]. For example:
Avoid using the [[Number sign|{{!xt|#}}]] symbol (known as the [[number sign]], hash sign, pound sign, or octothorpe) when referring to numbers or rankings. Instead write {{xt|number}}, {{xt|No.}} or {{xt|Nos.}}; do not use the symbol [[Numero sign|{{!xt|№}}]]. For example:
Line 1,284: Line 1,284:


An exception is issue numbers of comic books, which unlike for other periodicals are conventionally given in general text in the form {{xt|#1}}, unless a volume is also given, in which case write {{xt|volume two, number seven}} or {{xt|{{Abbr|Vol.|Volume}} 2, {{Abbr|No.|Number}} 7}}. Another exception are periodical publications carrying both, issue ''and'' number designations (typically one being a year-relative and the other an absolute value); they should be given in the form {{xt|2 #143}} in citations, or be spelt out as
An exception is issue numbers of comic books, which unlike for other periodicals are conventionally given in general text in the form {{xt|#1}}, unless a volume is also given, in which case write {{xt|volume two, number seven}} or {{xt|{{Abbr|Vol.|Volume}} 2, {{Abbr|No.|Number}} 7}}. Another exception are periodical publications carrying both, issue ''and'' number designations (typically one being a year-relative and the other an absolute value); they should be given in the form {{xt|2 #143}} in citations, or be spelt out as
{{xt|{{Abbr|Iss.|Issue}} 2, {{Abbr|No.|Number}} 143}} in text. When using the [[BattleTechWiki:Manual of Style/Abbreviations|abbreviations]], write {{xt|<code><nowiki>{{abbr|Vol.|Volume}}</nowiki></code>}}, {{xt|<code><nowiki>{{abbr|Iss.|Issue}}</nowiki></code>}}, {{xt|<code><nowiki>{{abbr|No.|Number}}</nowiki></code>}}, or {{xt|<code><nowiki>{{abbr|Nos.|Numbers}}</nowiki></code>}}, at first occurrence.
{{xt|{{Abbr|Iss.|Issue}} 2, {{Abbr|No.|Number}} 143}} in text. When using the [[BattleIntelligence:Manual of Style/Abbreviations|abbreviations]], write {{xt|<code><nowiki>{{abbr|Vol.|Volume}}</nowiki></code>}}, {{xt|<code><nowiki>{{abbr|Iss.|Issue}}</nowiki></code>}}, {{xt|<code><nowiki>{{abbr|No.|Number}}</nowiki></code>}}, or {{xt|<code><nowiki>{{abbr|Nos.|Numbers}}</nowiki></code>}}, at first occurrence.


===Terminal punctuation<span id="Punctuation at the end of a sentence"></span>===
===Terminal punctuation<span id="Punctuation at the end of a sentence"></span>===
Line 1,320: Line 1,320:
===Punctuation and footnotes===
===Punctuation and footnotes===
{{Shortcut|MOS:CITEPUNCT|MOS:PUNCTFOOT|MOS:REFPUNCT|MOS:PUNCTREF|MOS:REFSPACE|MOS:PF}}
{{Shortcut|MOS:CITEPUNCT|MOS:PUNCTFOOT|MOS:REFPUNCT|MOS:PUNCTREF|MOS:REFSPACE|MOS:PF}}
{{See also|BattleTechWiki:Citing sources}}
{{See also|BattleIntelligence:Citing sources}}


'''Ref tags''' ({{tag|ref}}) are used to create ''[[Help:Footnotes|footnotes]]'' (sometimes called ''endnotes'' or just ''notes''), as [[BattleTechWiki:Citing sources#Inline citations|citation footnotes]] and sometimes [[Help:Explanatory notes|explanatory notes]]. All ref tags should {{em|immediately}} follow the text to which the footnote applies, with no intervening space. Refs are placed {{em|after}} adjacent punctuation, not before (apart from the exceptions below). Adjacent ref tags should have no space between them, nor should there be any between ref tags and [[:Category:Inline templates|inline dispute/cleanup templates]].
'''Ref tags''' ({{tag|ref}}) are used to create ''[[Help:Footnotes|footnotes]]'' (sometimes called ''endnotes'' or just ''notes''), as [[BattleIntelligence:Citing sources#Inline citations|citation footnotes]] and sometimes [[Help:Explanatory notes|explanatory notes]]. All ref tags should {{em|immediately}} follow the text to which the footnote applies, with no intervening space. Refs are placed {{em|after}} adjacent punctuation, not before (apart from the exceptions below). Adjacent ref tags should have no space between them, nor should there be any between ref tags and [[:Category:Inline templates|inline dispute/cleanup templates]].


When ref tags are used, a [[Help:Footnotes#Creating the footnote list|footnote list]] must be added, and this is usually placed in the [[BattleTechWiki:Manual of Style/Layout#Notes and references|References]] section, near the end of the article in the [[BattleTechWiki:Manual of Style/Layout#Standard appendices and footers|standard appendices and footers]].
When ref tags are used, a [[Help:Footnotes#Creating the footnote list|footnote list]] must be added, and this is usually placed in the [[BattleIntelligence:Manual of Style/Layout#Notes and references|References]] section, near the end of the article in the [[BattleIntelligence:Manual of Style/Layout#Standard appendices and footers|standard appendices and footers]].


{{Hatnote|Note: In the examples below, the superscript callouts (for example here{{Dummy ref|10}}) are dummies and are not clickable.}}
{{Hatnote|Note: In the examples below, the superscript callouts (for example here{{Dummy ref|10}}) are dummies and are not clickable.}}
Line 1,334: Line 1,334:


===Punctuation after formulae===
===Punctuation after formulae===
A sentence that ends with a formula should have terminal punctuation (period, exclamation mark, or question mark) after the formula. Within a sentence, place other punctuation (such as commas or colons) after the formula just as if the text were not a formula. See {{section link|BattleTechWiki:Manual of Style/Mathematics|Punctuation after formulae}}.
A sentence that ends with a formula should have terminal punctuation (period, exclamation mark, or question mark) after the formula. Within a sentence, place other punctuation (such as commas or colons) after the formula just as if the text were not a formula. See {{section link|BattleIntelligence:Manual of Style/Mathematics|Punctuation after formulae}}.


==Dates and time==
==Dates and time==
{{Main|BattleTechWiki:Manual of Style/Dates and numbers#Chronological items}}
{{Main|BattleIntelligence:Manual of Style/Dates and numbers#Chronological items}}


For ranges of dates and times, see {{section link||En dashes: other uses}}.
For ranges of dates and times, see {{section link||En dashes: other uses}}.


Dates should be [[BattleTechWiki:Linking|linked]] only when they are germane and topical to the subject, as discussed at {{section link|BattleTechWiki:Manual of Style/Linking|Chronological items}}.
Dates should be [[BattleIntelligence:Linking|linked]] only when they are germane and topical to the subject, as discussed at {{section link|BattleIntelligence:Manual of Style/Linking|Chronological items}}.


===Time of day===
===Time of day===
Line 1,355: Line 1,355:
Full dates are formatted {{xt|{{nobr|10 June 1921}}}} or {{xt|{{nobr|June 10, 1921}}}}; or where the year is omitted, use {{xt|{{nobr|10 June}}}} or {{xt|{{nobr|June 10}}}}.
Full dates are formatted {{xt|{{nobr|10 June 1921}}}} or {{xt|{{nobr|June 10, 1921}}}}; or where the year is omitted, use {{xt|{{nobr|10 June}}}} or {{xt|{{nobr|June 10}}}}.
*The dates in the ''text'' of any one article should all have the same format (day-first or month-first).
*The dates in the ''text'' of any one article should all have the same format (day-first or month-first).
**For date formats in citations, see {{section link|BattleTechWiki:Citing sources|Citation style}}.
**For date formats in citations, see {{section link|BattleIntelligence:Citing sources|Citation style}}.
**Dates in quotations and titles are always left as-is.
**Dates in quotations and titles are always left as-is.
**If a numerical format is required (e.g., for conciseness in lists and tables), use the YYYY-MM-DD format: {{xt|{{nobr|2005-04-03}}}}.
**If a numerical format is required (e.g., for conciseness in lists and tables), use the YYYY-MM-DD format: {{xt|{{nobr|2005-04-03}}}}.
Line 1,369: Line 1,369:
*Avoid ambiguous references to [[seasons]], which are different in the southern and northern hemispheres.
*Avoid ambiguous references to [[seasons]], which are different in the southern and northern hemispheres.
*Names of seasons may be used when there is a logical connection to the event being described ({{xt|the autumn harvest}}) or when referring to a phase of a natural yearly cycle ({{xt|migration typically starts in mid-spring}}). Otherwise, neutral wording is usually preferable ({{xt|He was elected in November 1992}}, not {{!xt|He was elected in the fall of 1992}}).
*Names of seasons may be used when there is a logical connection to the event being described ({{xt|the autumn harvest}}) or when referring to a phase of a natural yearly cycle ({{xt|migration typically starts in mid-spring}}). Otherwise, neutral wording is usually preferable ({{xt|He was elected in November 1992}}, not {{!xt|He was elected in the fall of 1992}}).
*Journals and other publications that are issued seasonally (e.g., "Summer 2005") should be dated as such in citations {{crossref|(for more information, see {{section link|BattleTechWiki:Citing sources|Seasonal publication dates and differing calendar systems}})}}.
*Journals and other publications that are issued seasonally (e.g., "Summer 2005") should be dated as such in citations {{crossref|(for more information, see {{section link|BattleIntelligence:Citing sources|Seasonal publication dates and differing calendar systems}})}}.


===Years and longer periods===
===Years and longer periods===
Line 1,377: Line 1,377:
*Years are denoted by [[Anno Domini|AD and BC]] or, equivalently, [[Common Era|CE and BCE]]. Use only one system within an article, and do not change from one system to the other without good reason. The abbreviations are written without periods, and with a [[#Non-breaking spaces|non-breaking space]], as in {{xt|5&nbsp;BC}}. Omit AD or CE unless omitting it would cause ambiguity.
*Years are denoted by [[Anno Domini|AD and BC]] or, equivalently, [[Common Era|CE and BCE]]. Use only one system within an article, and do not change from one system to the other without good reason. The abbreviations are written without periods, and with a [[#Non-breaking spaces|non-breaking space]], as in {{xt|5&nbsp;BC}}. Omit AD or CE unless omitting it would cause ambiguity.


More information on all the above topics can be found at {{section link|BattleTechWiki:Manual of Style/Dates and numbers|Chronological items}}, including the handling of dates expressed in different calendars, and times corresponding to different time zones.
More information on all the above topics can be found at {{section link|BattleIntelligence:Manual of Style/Dates and numbers|Chronological items}}, including the handling of dates expressed in different calendars, and times corresponding to different time zones.


===Current===
===Current===
{{See also|BattleTechWiki:As of|BattleTechWiki:Manual of Style/Words to watch#Relative time references}}
{{See also|BattleIntelligence:As of|BattleIntelligence:Manual of Style/Words to watch#Relative time references}}


Terms such as "current", "now", and "recent" should be avoided. What is current today may not be tomorrow; situations change over time. Instead, use date- and time-specific text. To help keep information updated use {{tlx|As of}}, which will allow editors to catalog and update dated statements.
Terms such as "current", "now", and "recent" should be avoided. What is current today may not be tomorrow; situations change over time. Instead, use date- and time-specific text. To help keep information updated use {{tlx|As of}}, which will allow editors to catalog and update dated statements.
Line 1,392: Line 1,392:


==Numbers<span id="Spelling out numbers"></span>==
==Numbers<span id="Spelling out numbers"></span>==
{{Main|BattleTechWiki:Manual of Style/Dates and numbers#Numbers}}
{{Main|BattleIntelligence:Manual of Style/Dates and numbers#Numbers}}
*Integers from zero to nine are spelled out in words. Integers greater than nine {{em|expressible in one or two words}} may be expressed either in numerals or in words. Other numbers are given in numerals or in forms such as {{xt|21{{nbsp}}million}}. See {{section link|MOS:NUM|Numbers as figures or words}}.
*Integers from zero to nine are spelled out in words. Integers greater than nine {{em|expressible in one or two words}} may be expressed either in numerals or in words. Other numbers are given in numerals or in forms such as {{xt|21{{nbsp}}million}}. See {{section link|MOS:NUM|Numbers as figures or words}}.
*In general, in numbers with five or more digits to the left of the decimal point, use commas to group those digits. Numbers with four digits are at the editor's discretion: {{xt|12,345}}, but either {{xt|1,000}} or {{xt|1000}}. See {{section link|MOS:NUM|Grouping of digits}}.
*In general, in numbers with five or more digits to the left of the decimal point, use commas to group those digits. Numbers with four digits are at the editor's discretion: {{xt|12,345}}, but either {{xt|1,000}} or {{xt|1000}}. See {{section link|MOS:NUM|Grouping of digits}}.
Line 1,402: Line 1,402:


==Currencies==
==Currencies==
{{Main|BattleTechWiki:Manual of Style/Dates and numbers#Currencies and monetary values}}
{{Main|BattleIntelligence:Manual of Style/Dates and numbers#Currencies and monetary values}}
*Use the full abbreviation on first use ({{xt|US$}} for the US dollar and {{xt|A$}} for the Australian dollar), {{em|unless the currency is already clear from context}}. For example, the government of the United States always spends money in American dollars, and never in Canadian or Australian dollars.
*Use the full abbreviation on first use ({{xt|US$}} for the US dollar and {{xt|A$}} for the Australian dollar), {{em|unless the currency is already clear from context}}. For example, the government of the United States always spends money in American dollars, and never in Canadian or Australian dollars.
*Use only one symbol with ranges, as in {{xt|$250–300}}.
*Use only one symbol with ranges, as in {{xt|$250–300}}.
Line 1,411: Line 1,411:


==Units of measurement==
==Units of measurement==
{{Main|BattleTechWiki:Manual of Style/Dates and numbers#Units of measurement}}
{{Main|BattleIntelligence:Manual of Style/Dates and numbers#Units of measurement}}
*The main unit in which a quantity is expressed should generally be an [[International System of Units|SI]] unit or [[Non-SI units mentioned in the SI|non-SI unit officially accepted for use with the SI]]. However,
*The main unit in which a quantity is expressed should generally be an [[International System of Units|SI]] unit or [[Non-SI units mentioned in the SI|non-SI unit officially accepted for use with the SI]]. However,
**Scientific articles may also use specialist units appropriate for the branch of science in question.
**Scientific articles may also use specialist units appropriate for the branch of science in question.
Line 1,417: Line 1,417:
**In non-scientific articles with strong ties to the United Kingdom, although the main unit is generally a metric unit ({{xt|10 kilograms (22 lb)}}), imperial units are still used as the main units in some contexts ({{xt|7 miles (11 km) by road}}).
**In non-scientific articles with strong ties to the United Kingdom, although the main unit is generally a metric unit ({{xt|10 kilograms (22 lb)}}), imperial units are still used as the main units in some contexts ({{xt|7 miles (11 km) by road}}).
*Where English-speaking countries use different units for the same measurement, provide a conversion in parentheses. Examples: {{xt|the Mississippi River is {{convert|2320|mi|km|0}} long}}; {{xt|the Murray River is {{convert|2375|km|mi|0}} long}}. See {{tlx|convert}}.
*Where English-speaking countries use different units for the same measurement, provide a conversion in parentheses. Examples: {{xt|the Mississippi River is {{convert|2320|mi|km|0}} long}}; {{xt|the Murray River is {{convert|2375|km|mi|0}} long}}. See {{tlx|convert}}.
*In a direct quotation, always retain the source's units. Any conversion should follow in square brackets (or, an obscure use of units can be explained in the article text or a [[BattleTechWiki:Footnotes|footnote]]).
*In a direct quotation, always retain the source's units. Any conversion should follow in square brackets (or, an obscure use of units can be explained in the article text or a [[BattleIntelligence:Footnotes|footnote]]).
*Where space is limited (such as tables, infoboxes, parenthetical notes, and mathematical formulas) unit symbols are preferred. In prose, unit names should be given in full if used only a few times but symbols may be used when a unit (especially one with a long name) is used repeatedly after spelling out the first use (e.g., {{xt|Up to 15 kilograms of filler is used for a batch of 250{{nbsp}}kg}}), except for unit names that are hardly ever spelled out ({{xt|°C}} rather than {{!xt|degrees Celsius}}).
*Where space is limited (such as tables, infoboxes, parenthetical notes, and mathematical formulas) unit symbols are preferred. In prose, unit names should be given in full if used only a few times but symbols may be used when a unit (especially one with a long name) is used repeatedly after spelling out the first use (e.g., {{xt|Up to 15 kilograms of filler is used for a batch of 250{{nbsp}}kg}}), except for unit names that are hardly ever spelled out ({{xt|°C}} rather than {{!xt|degrees Celsius}}).
*Most unit names are not capitalized (see {{section link||National varieties of English}} for spelling differences).
*Most unit names are not capitalized (see {{section link||National varieties of English}} for spelling differences).
*Use "per" when writing out a unit, rather than a slash: {{xt|metre per second}}, not {{!xt|metre/second}}.
*Use "per" when writing out a unit, rather than a slash: {{xt|metre per second}}, not {{!xt|metre/second}}.
*Units unfamiliar to general readers should be presented as a name–symbol pair on first use, linking the unit name ({{xt|Energies were originally 2.3 [[megaelectronvolt]]s (MeV), but were eventually 6{{nbsp}}MeV}}).
*Units unfamiliar to general readers should be presented as a name–symbol pair on first use, linking the unit name ({{xt|Energies were originally 2.3 [[megaelectronvolt]]s (MeV), but were eventually 6{{nbsp}}MeV}}).
*For ranges, see {{section link||En dashes: other uses}}, and MOS:NUM, at {{section link|nopage=y|BattleTechWiki:Manual of Style/Dates and numbers|Date ranges|Percentages|Unit names and symbols|Formatting of monetary values}}.
*For ranges, see {{section link||En dashes: other uses}}, and MOS:NUM, at {{section link|nopage=y|BattleIntelligence:Manual of Style/Dates and numbers|Date ranges|Percentages|Unit names and symbols|Formatting of monetary values}}.
*Unit symbols are preceded by figures, not by spelled-out numbers. Values and unit symbols are separated by a [[non-breaking space]]. For example, {{xt|5&nbsp;min}}. The percent sign and units of degrees, minutes, and seconds {{em|for angles and coordinates}} are unspaced.
*Unit symbols are preceded by figures, not by spelled-out numbers. Values and unit symbols are separated by a [[non-breaking space]]. For example, {{xt|5&nbsp;min}}. The percent sign and units of degrees, minutes, and seconds {{em|for angles and coordinates}} are unspaced.


==Common mathematical symbols==
==Common mathematical symbols==
{{Shortcut|MOS:COMMONMATH}}
{{Shortcut|MOS:COMMONMATH}}
{{See also|BattleTechWiki:Manual of Style/Mathematics}}
{{See also|BattleIntelligence:Manual of Style/Mathematics}}
*For a negative sign or subtraction operator, use a minus sign ({{xt|−}}, Unicode character U+2212 <small>MINUS SIGN</small>). Input by clicking on it in the insert box beneath the edit window or by typing <code>&amp;minus;</code>.
*For a negative sign or subtraction operator, use a minus sign ({{xt|−}}, Unicode character U+2212 <small>MINUS SIGN</small>). Input by clicking on it in the insert box beneath the edit window or by typing <code>&amp;minus;</code>.
*For multiplication, use a multiplication sign ({{unichar|d7|MULTIPLICATION SIGN}}) or a dot ({{unichar|22c5|DOT OPERATOR}}), which are input by clicking on them in the edit toolbox under the edit window or by entering <code>&amp;times;</code> or <code>&amp;sdot;</code>. Care should be taken not to confuse the dot operator (in the "Math and logic" section of the edit toolbox) with an interpunct (in the "Insert" section of the edit toolbox) or a bullet. The letter {{xt|x}} should not be used to indicate multiplication, but it is used (unspaced) as the substitute for "by" in terms such as {{xt|[[4x4]]}}.
*For multiplication, use a multiplication sign ({{unichar|d7|MULTIPLICATION SIGN}}) or a dot ({{unichar|22c5|DOT OPERATOR}}), which are input by clicking on them in the edit toolbox under the edit window or by entering <code>&amp;times;</code> or <code>&amp;sdot;</code>. Care should be taken not to confuse the dot operator (in the "Math and logic" section of the edit toolbox) with an interpunct (in the "Insert" section of the edit toolbox) or a bullet. The letter {{xt|x}} should not be used to indicate multiplication, but it is used (unspaced) as the substitute for "by" in terms such as {{xt|[[4x4]]}}.
Line 1,465: Line 1,465:
===Pronouns===
===Pronouns===
{{shortcut|MOS:PRONOUN}}
{{shortcut|MOS:PRONOUN}}
{{See also|BattleTechWiki:Writing better articles#Use of pronouns}}
{{See also|BattleIntelligence:Writing better articles#Use of pronouns}}


====First-person pronouns<span class="anchor" id="First-person pronouns"></span>====
====First-person pronouns<span class="anchor" id="First-person pronouns"></span>====
Line 1,472: Line 1,472:
To maintain an objective and impersonal encyclopedic voice, an article should never refer to its editors or readers using ''I'', ''my'', ''we'', ''us'', ''our'', or similar words: {{!xt|We note that some believe that bats are bugs}}. But some of these words are acceptable in certain figurative uses. For example:
To maintain an objective and impersonal encyclopedic voice, an article should never refer to its editors or readers using ''I'', ''my'', ''we'', ''us'', ''our'', or similar words: {{!xt|We note that some believe that bats are bugs}}. But some of these words are acceptable in certain figurative uses. For example:
*In historical articles to mean the modern world as a whole: {{xt|Only portions of ''De re publica'' have come down to us.}}
*In historical articles to mean the modern world as a whole: {{xt|Only portions of ''De re publica'' have come down to us.}}
*The [[author's we|author's ''we'']] found in scientific writing ({{xt|We construct {{mvar|S}} as follows}}), though [[English passive voice|passive voice]] may be preferable ({{xt|{{mvar|S}} is constructed as follows}}).The [[English passive voice|passive voice]] is inappropriate for some forms of writing, but it is widely used in encyclopedia articles, because the passive voice avoids inappropriate first- and second-person constructions as well as tone problems. The most common uses of encyclopedic passive are to keep the focus on the subject instead of performing a [[BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not a newspaper|news-style]] shift to dwelling on a non-notable party. Contrast {{xt|The break-in was reported to police the next morning}}, versus {{!xt|Assistant manager Peggy Plimpton-Chan reported the break-in to police the next morning}}.}}
*The [[author's we|author's ''we'']] found in scientific writing ({{xt|We construct {{mvar|S}} as follows}}), though [[English passive voice|passive voice]] may be preferable ({{xt|{{mvar|S}} is constructed as follows}}).The [[English passive voice|passive voice]] is inappropriate for some forms of writing, but it is widely used in encyclopedia articles, because the passive voice avoids inappropriate first- and second-person constructions as well as tone problems. The most common uses of encyclopedic passive are to keep the focus on the subject instead of performing a [[BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not a newspaper|news-style]] shift to dwelling on a non-notable party. Contrast {{xt|The break-in was reported to police the next morning}}, versus {{!xt|Assistant manager Peggy Plimpton-Chan reported the break-in to police the next morning}}.}}


====Second-person pronouns<span class="anchor" id="Second-person pronouns"></span>====
====Second-person pronouns<span class="anchor" id="Second-person pronouns"></span>====
{{Shortcut|MOS:YOU|MOS:BAIT|MOS:PEDAGOGY|MOS:SOCRATIC}}
{{Shortcut|MOS:YOU|MOS:BAIT|MOS:PEDAGOGY|MOS:SOCRATIC}}
{{redirect|BTW:YOU|"BattleTechWiki is not about {{em|you}}"|BTW:NOTYOU}}
{{redirect|BTW:YOU|"BattleIntelligence is not about {{em|you}}"|BTW:NOTYOU}}


Avoid addressing the reader using ''you'' or ''your'', which sets an inappropriate tone {{crossref|(see also {{section link||Instructional and presumptuous language}})}}.
Avoid addressing the reader using ''you'' or ''your'', which sets an inappropriate tone {{crossref|(see also {{section link||Instructional and presumptuous language}})}}.
Line 1,484: Line 1,484:
*Do not bait links, e.g., "{{!xt|Click here for more information}}"; let the browser's normal highlighting invite a click. ("{{!xt|Click here}}" also makes no sense to someone reading on paper.)
*Do not bait links, e.g., "{{!xt|Click here for more information}}"; let the browser's normal highlighting invite a click. ("{{!xt|Click here}}" also makes no sense to someone reading on paper.)
*Likewise, "See: (reference)" or "Consider&nbsp;..." are milder second-person baits, common in academic writing ([[pedagogy]]). This interactive personality is inconsistent with an encyclopedia's passive presentation of objective matter.
*Likewise, "See: (reference)" or "Consider&nbsp;..." are milder second-person baits, common in academic writing ([[pedagogy]]). This interactive personality is inconsistent with an encyclopedia's passive presentation of objective matter.
**"See" and the like can be used to internally cross-reference other BattleTechWiki material. Do not italicize words like "see". Such a cross reference should be parenthetical, so the article text stands alone if the parenthetical is removed. {{tlx|Cross reference}} can be used for this: {{tlx|Cross reference|(see <nowiki>[[Chicken]]</nowiki>)}}, {{tlx|Cross reference|(See <nowiki>[[Dacian language]]</nowiki> for details.)}} It is usually better to rewrite the material to integrate these links contextually rather than use [[BattleTechWiki:Manual of Style/Self-references to avoid|explicit BattleTechWiki self-references]].
**"See" and the like can be used to internally cross-reference other BattleIntelligence material. Do not italicize words like "see". Such a cross reference should be parenthetical, so the article text stands alone if the parenthetical is removed. {{tlx|Cross reference}} can be used for this: {{tlx|Cross reference|(see <nowiki>[[Chicken]]</nowiki>)}}, {{tlx|Cross reference|(See <nowiki>[[Dacian language]]</nowiki> for details.)}} It is usually better to rewrite the material to integrate these links contextually rather than use [[BattleIntelligence:Manual of Style/Self-references to avoid|explicit BattleIntelligence self-references]].
*Do not address the reader with the [[Socratic method]] by asking and answering questions. {{!xt|Did [[Francis Bacon|Bacon]] write [[Shakespeare]]? Then who wrote Bacon?}}
*Do not address the reader with the [[Socratic method]] by asking and answering questions. {{!xt|Did [[Francis Bacon|Bacon]] write [[Shakespeare]]? Then who wrote Bacon?}}


Line 1,490: Line 1,490:
{{Shortcut|MOS:PLURALS|MOS:SINGULAR}}
{{Shortcut|MOS:PLURALS|MOS:SINGULAR}}
{{See also|English plurals|Collective noun}}
{{See also|English plurals|Collective noun}}
{{for|the article title guideline|BattleTechWiki:Naming conventions (plurals)}}
{{for|the article title guideline|BattleIntelligence:Naming conventions (plurals)}}


Use the appropriate plural; allow for cases (such as ''[[excursus]]'' or ''[[hanif]]'') in which a word is now listed in major English dictionaries, and normally takes an ''s'' or ''es'' plural, not its original plural: {{xt|two excursuses}}, not {{!xt|two ''excursus''}} as in Latin; {{xt|three hanifs}}, not {{!xt|three ''hunafa''}} as in Arabic.
Use the appropriate plural; allow for cases (such as ''[[excursus]]'' or ''[[hanif]]'') in which a word is now listed in major English dictionaries, and normally takes an ''s'' or ''es'' plural, not its original plural: {{xt|two excursuses}}, not {{!xt|two ''excursus''}} as in Latin; {{xt|three hanifs}}, not {{!xt|three ''hunafa''}} as in Arabic.
Line 1,500: Line 1,500:
===Verb tense<span class="anchor" id="Tense"></span><span class="anchor" id="TENSE"></span><span class="anchor" id="VERBTENSE"></span>===
===Verb tense<span class="anchor" id="Tense"></span><span class="anchor" id="TENSE"></span><span class="anchor" id="VERBTENSE"></span>===
{{Shortcut|MOS:TENSE|MOS:VERB|MOS:WAS|MOS:COMPNOW}}
{{Shortcut|MOS:TENSE|MOS:VERB|MOS:WAS|MOS:COMPNOW}}
{{redirect|MOS:PRESENT|text=For the guideline on words such as "currently", "soon", and "recently", see {{slink|BattleTechWiki:Manual of Style/Dates and numbers#Statements likely to become outdated}}}}
{{redirect|MOS:PRESENT|text=For the guideline on words such as "currently", "soon", and "recently", see {{slink|BattleIntelligence:Manual of Style/Dates and numbers#Statements likely to become outdated}}}}
{{See also|BattleTechWiki:Manual of Style/Biography#Tense|BattleTechWiki:Manual of Style/Words to watch#Relative time references|BattleTechWiki:Writing better articles#Tense in fiction}}
{{See also|BattleIntelligence:Manual of Style/Biography#Tense|BattleIntelligence:Manual of Style/Words to watch#Relative time references|BattleIntelligence:Writing better articles#Tense in fiction}}


By default, write articles in the present tense, including those covering works of fiction {{crossref|(see {{section link|BattleTechWiki:Writing better articles|Tense in fiction}})}} and products or works that have been discontinued. Generally, use past tense only for past events, and for subjects that are dead or no longer meaningfully exist. Use past tense for articles about periodicals no longer produced, with common-sense exceptions.<!-- RfC that resulted in preceding sentence at https://en.wikipedia.org/wiki/Special:Permalink/974747679#RfC:_Should_"is"_or_"was"_be_used_to_describe_periodical_publications_that_are_no_longer_being_published? -->
By default, write articles in the present tense, including those covering works of fiction {{crossref|(see {{section link|BattleIntelligence:Writing better articles|Tense in fiction}})}} and products or works that have been discontinued. Generally, use past tense only for past events, and for subjects that are dead or no longer meaningfully exist. Use past tense for articles about periodicals no longer produced, with common-sense exceptions.<!-- RfC that resulted in preceding sentence at https://en.wikipedia.org/wiki/Special:Permalink/974747679#RfC:_Should_"is"_or_"was"_be_used_to_describe_periodical_publications_that_are_no_longer_being_published? -->
*{{xt|The PDP-10 is a mainframe computer family manufactured by Digital Equipment Corporation from 1966 into the 1980s.}}
*{{xt|The PDP-10 is a mainframe computer family manufactured by Digital Equipment Corporation from 1966 into the 1980s.}}
*{{xt|''Earth: Final Conflict'' is a Canadian science fiction television series that ran for five seasons between October 6, 1997, and May 20, 2002.}}
*{{xt|''Earth: Final Conflict'' is a Canadian science fiction television series that ran for five seasons between October 6, 1997, and May 20, 2002.}}
Line 1,520: Line 1,520:
===Contractions===
===Contractions===
{{shortcut|MOS:CONTRACTIONS}}
{{shortcut|MOS:CONTRACTIONS}}
{{Main|BattleTechWiki:Manual of Style/Abbreviations#Contractions}}
{{Main|BattleIntelligence:Manual of Style/Abbreviations#Contractions}}


Avoid [[Contraction (grammar)|contractions]], which have little place in formal writing. For example, write {{xt|''do not''}} instead of {{!xt|''don't''}}. Use of {{xt|o'clock}} is an exception. Contracted titles such as {{!xt|Dr.}} and {{!xt|St}} generally should not be used but may apply in some contexts (e.g., quoted material, place names, titles of works).
Avoid [[Contraction (grammar)|contractions]], which have little place in formal writing. For example, write {{xt|''do not''}} instead of {{!xt|''don't''}}. Use of {{xt|o'clock}} is an exception. Contracted titles such as {{!xt|Dr.}} and {{!xt|St}} generally should not be used but may apply in some contexts (e.g., quoted material, place names, titles of works).
Line 1,526: Line 1,526:
===Gender-neutral language===
===Gender-neutral language===
{{Redirect|MOS:GENDER|the style guideline regarding pronoun usage for individuals whose gender might be questioned|MOS:GENDERID}}
{{Redirect|MOS:GENDER|the style guideline regarding pronoun usage for individuals whose gender might be questioned|MOS:GENDERID}}
{{for|an essay with suggestions and sample usage|BattleTechWiki:Gender-neutral language}}
{{for|an essay with suggestions and sample usage|BattleIntelligence:Gender-neutral language}}
{{See also|BattleTechWiki:Writing about women}}
{{See also|BattleIntelligence:Writing about women}}
{{Shortcut|MOS:GNL|MOS:S/HE}}
{{Shortcut|MOS:GNL|MOS:S/HE}}


Line 1,534: Line 1,534:
References to space programs, past, present and future, should use gender-neutral phrasing: {{xt|human spaceflight}}, {{xt|robotic probe}}, {{xt|uncrewed mission}}, {{xt|crewed spacecraft}}, {{xt|piloted}}, {{xt|unpiloted}}, {{xt|astronaut}}, {{xt|cosmonaut}}, not {{!xt|manned}} or {{!xt|unmanned}}. Direct quotations and proper nouns that use gendered words should not be changed, like {{xt|Manned Maneuvering Unit}}.
References to space programs, past, present and future, should use gender-neutral phrasing: {{xt|human spaceflight}}, {{xt|robotic probe}}, {{xt|uncrewed mission}}, {{xt|crewed spacecraft}}, {{xt|piloted}}, {{xt|unpiloted}}, {{xt|astronaut}}, {{xt|cosmonaut}}, not {{!xt|manned}} or {{!xt|unmanned}}. Direct quotations and proper nouns that use gendered words should not be changed, like {{xt|Manned Maneuvering Unit}}.
{{Shortcut|MOS:SHIP}}
{{Shortcut|MOS:SHIP}}
Ships may be referred to using either neuter forms ("it", "its") or feminine forms ("she", "her", "hers"). Either usage is acceptable, but each article should be internally consistent and employ one or the other exclusively. As with all optional styles, articles should not be changed from one style to another unless there is a substantial reason to do so. See {{section link|BattleTechWiki:Manual of Style/Military history|Pronouns}}.
Ships may be referred to using either neuter forms ("it", "its") or feminine forms ("she", "her", "hers"). Either usage is acceptable, but each article should be internally consistent and employ one or the other exclusively. As with all optional styles, articles should not be changed from one style to another unless there is a substantial reason to do so. See {{section link|BattleIntelligence:Manual of Style/Military history|Pronouns}}.


===Contested vocabulary===
===Contested vocabulary===
Line 1,541: Line 1,541:
===Instructional and presumptuous language===
===Instructional and presumptuous language===
{{Shortcut|MOS:INSTRUCT||MOS:NOTE|MOS:NOTETHAT|MOS:NOTED|MOS:PRESUME|MOS:QUESTION}}
{{Shortcut|MOS:INSTRUCT||MOS:NOTE|MOS:NOTETHAT|MOS:NOTED|MOS:PRESUME|MOS:QUESTION}}
{{redirect|MOS:NOTE|footnotes|Help:Footnotes|hatnotes|BattleTechWiki:Hatnote|musical notes|BattleTechWiki:Manual of Style/Music#Images and notation}}
{{redirect|MOS:NOTE|footnotes|Help:Footnotes|hatnotes|BattleIntelligence:Hatnote|musical notes|BattleIntelligence:Manual of Style/Music#Images and notation}}
{{See also|BattleTechWiki:Manual of Style/Words to watch#Editorializing|BattleTechWiki:Writing better articles#Information style and tone|BattleTechWiki:Manual of Style/Self-references to avoid#Note that&nbsp;...}}
{{See also|BattleIntelligence:Manual of Style/Words to watch#Editorializing|BattleIntelligence:Writing better articles#Information style and tone|BattleIntelligence:Manual of Style/Self-references to avoid#Note that&nbsp;...}}


Avoid phrases such as {{!xt|remember that}} and {{!xt|note that}}, which [[Imperative mood|address readers directly]] in an [[BattleTechWiki:Writing better articles#Tone|unencyclopedic tone]] and lean toward [[BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not a manual, guidebook, textbook, or scientific journal|instructional]]. They are a subtle form of [[BattleTechWiki:Manual of Style/Self-references to avoid|BattleTechWiki self-reference]], "breaking the [[fourth wall]]". Similarly, phrases such as {{!xt|of course}}, {{!xt|naturally}}, {{!xt|obviously}}, {{!xt|clearly}}, and {{!xt|actually}} make presumptions about readers' knowledge, may [[BattleTechWiki:Neutral point of view|express a viewpoint]], and may call into question the reason for including the information in the first place. Do not {{em|tell}} readers that something is interesting, ironic, surprising, unexpected, amusing, coincidental, etc. Simply present sourced facts neutrally and allow readers to draw their own conclusions. Such constructions can usually just be deleted, leaving behind proper sentences with a more academic and less pushy tone: {{!xt|Note that this was naturally subject to controversy in more conservative newspapers.}} becomes {{xt|This was subject to controversy in more conservative newspapers.}}
Avoid phrases such as {{!xt|remember that}} and {{!xt|note that}}, which [[Imperative mood|address readers directly]] in an [[BattleIntelligence:Writing better articles#Tone|unencyclopedic tone]] and lean toward [[BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not a manual, guidebook, textbook, or scientific journal|instructional]]. They are a subtle form of [[BattleIntelligence:Manual of Style/Self-references to avoid|BattleIntelligence self-reference]], "breaking the [[fourth wall]]". Similarly, phrases such as {{!xt|of course}}, {{!xt|naturally}}, {{!xt|obviously}}, {{!xt|clearly}}, and {{!xt|actually}} make presumptions about readers' knowledge, may [[BattleIntelligence:Neutral point of view|express a viewpoint]], and may call into question the reason for including the information in the first place. Do not {{em|tell}} readers that something is interesting, ironic, surprising, unexpected, amusing, coincidental, etc. Simply present sourced facts neutrally and allow readers to draw their own conclusions. Such constructions can usually just be deleted, leaving behind proper sentences with a more academic and less pushy tone: {{!xt|Note that this was naturally subject to controversy in more conservative newspapers.}} becomes {{xt|This was subject to controversy in more conservative newspapers.}}


Avoid rhetorical questions, especially [[BattleTechWiki:Manual of Style#Section headings|in headings]]. Use a heading of {{xt|Active listening}} and text such as {{xt|The term ''active listening'', coined in&nbsp;...}}, not {{!xt|What is ''active listening''?}}
Avoid rhetorical questions, especially [[BattleIntelligence:Manual of Style#Section headings|in headings]]. Use a heading of {{xt|Active listening}} and text such as {{xt|The term ''active listening'', coined in&nbsp;...}}, not {{!xt|What is ''active listening''?}}


For issues in the use of [[Template:Crossreference|cross-reference]]s{{snd}}e.g., {{xt|{{crossref|(see also [[Bulverism]]}})}}{{snd}}see {{sectionlink||Second-person pronouns}}.
For issues in the use of [[Template:Crossreference|cross-reference]]s{{snd}}e.g., {{xt|{{crossref|(see also [[Bulverism]]}})}}{{snd}}see {{sectionlink||Second-person pronouns}}.


===Subset terms===
===Subset terms===
{{See also|BattleTechWiki:Please clarify|BattleTechWiki:Vagueness}}
{{See also|BattleIntelligence:Please clarify|BattleIntelligence:Vagueness}}
{{Shortcut|MOS:SUBSET}}
{{Shortcut|MOS:SUBSET}}


Line 1,558: Line 1,558:
===Identity===
===Identity===
{{Shortcut|MOS:IDENTITY|MOS:ID}}
{{Shortcut|MOS:IDENTITY|MOS:ID}}
{{See also|BattleTechWiki:Manual of Style/Biographies#Child named for parent or predecessor|BattleTechWiki:Verifiability#Self-published or questionable sources as sources on themselves}}
{{See also|BattleIntelligence:Manual of Style/Biographies#Child named for parent or predecessor|BattleIntelligence:Verifiability#Self-published or questionable sources as sources on themselves}}


When there is a discrepancy between the term most commonly used by reliable sources for a person or group and the term that person or group uses for themselves, use the term that is most commonly used by recent reliable sources. If it is unclear which is most used, use the term that the person or group uses.
When there is a discrepancy between the term most commonly used by reliable sources for a person or group and the term that person or group uses for themselves, use the term that is most commonly used by recent reliable sources. If it is unclear which is most used, use the term that the person or group uses.


Disputes over how to refer to a person or group are addressed by BattleTechWiki [[BattleTechWiki:Content policies|content policies]], such as those on [[BattleTechWiki:Verifiability|verifiability]], and [[BattleTechWiki:Neutral point of view|neutral point of view]] (and [[BattleTechWiki:Article titles|article titles]] when the term appears in the title of an article).
Disputes over how to refer to a person or group are addressed by BattleIntelligence [[BattleIntelligence:Content policies|content policies]], such as those on [[BattleIntelligence:Verifiability|verifiability]], and [[BattleIntelligence:Neutral point of view|neutral point of view]] (and [[BattleIntelligence:Article titles|article titles]] when the term appears in the title of an article).


Use specific terminology. For example, it is often more appropriate for people or things from Ethiopia (a country in Africa) to be described as ''Ethiopian'', not carelessly (with the risk of [[stereotyping]]) as ''African''.
Use specific terminology. For example, it is often more appropriate for people or things from Ethiopia (a country in Africa) to be described as ''Ethiopian'', not carelessly (with the risk of [[stereotyping]]) as ''African''.


====Gender identity<span class="anchor" id="GENDERID"></span>====
====Gender identity<span class="anchor" id="GENDERID"></span>====
{{Main|BattleTechWiki:Manual of Style/Biography#Gender identity}}
{{Main|BattleIntelligence:Manual of Style/Biography#Gender identity}}


[[BattleTechWiki:Manual of Style/Biography#Gender identity|Specific guidelines apply]] to any person whose gender might be questioned, and any living transgender or non-binary person. In summary:
[[BattleIntelligence:Manual of Style/Biography#Gender identity|Specific guidelines apply]] to any person whose gender might be questioned, and any living transgender or non-binary person. In summary:
*Use gendered words only if they reflect the person's latest self-identification as reported in recent sources.
*Use gendered words only if they reflect the person's latest self-identification as reported in recent sources.
*If the person is living and was not notable yet when a former name was in use, that name should not be included in any BattleTechWiki page, even in quotations, as a privacy matter. Exception: Do not expunge or replace names in source citations (whether as authors or mentioned in work titles).
*If the person is living and was not notable yet when a former name was in use, that name should not be included in any BattleIntelligence page, even in quotations, as a privacy matter. Exception: Do not expunge or replace names in source citations (whether as authors or mentioned in work titles).
*Former names under which a living person was notable should be introduced with "born" or "formerly" in the lead sentence of their main biographical article. Name and gender matters should be explained at first appearance in that article, without overemphasis. In articles on works or other activities of such a person, use their current name by default, and give another name associated with that context in a parenthetical or footnote, only if they were notable under that name. In other articles, do not go into detail about such a person's name or gender except when directly relevant to the context.
*Former names under which a living person was notable should be introduced with "born" or "formerly" in the lead sentence of their main biographical article. Name and gender matters should be explained at first appearance in that article, without overemphasis. In articles on works or other activities of such a person, use their current name by default, and give another name associated with that context in a parenthetical or footnote, only if they were notable under that name. In other articles, do not go into detail about such a person's name or gender except when directly relevant to the context.
*Avoid confusing constructions by rewriting. Paraphrase, elide, or use square brackets to replace portions of quotations as needed to avoid confusion, former names, and mismatching gendered words.
*Avoid confusing constructions by rewriting. Paraphrase, elide, or use square brackets to replace portions of quotations as needed to avoid confusion, former names, and mismatching gendered words.
{{Crossref|printworthy=y|For examples and finer points, see {{section link|BattleTechWiki:Manual of Style/Biography#Gender identity}}.}}
{{Crossref|printworthy=y|For examples and finer points, see {{section link|BattleIntelligence:Manual of Style/Biography#Gender identity}}.}}


===Foreign terms===
===Foreign terms===
{{Shortcut|MOS:FOREIGN}}
{{Shortcut|MOS:FOREIGN}}
{{See also|BTW:Manual of Style/Accessibility#Other languages|BTW:Manual of Style/Lead section#Foreign language|:Category:BattleTechWiki Manual of Style (regional)|Help:Interlanguage links}}
{{See also|BTW:Manual of Style/Accessibility#Other languages|BTW:Manual of Style/Lead section#Foreign language|:Category:BattleIntelligence Manual of Style (regional)|Help:Interlanguage links}}


====Terms with common usage in English====
====Terms with common usage in English====
Line 1,586: Line 1,586:
==== Spelling and romanization ====
==== Spelling and romanization ====
{{Shortcut|MOS:Ñ|MOS:NOTLATIN|MOS:ROMANIZATION|MOS:ROMANISATION|MOS:DIACRITICS}}
{{Shortcut|MOS:Ñ|MOS:NOTLATIN|MOS:ROMANIZATION|MOS:ROMANISATION|MOS:DIACRITICS}}
{{See also|BattleTechWiki:Naming conventions (use English)#Modified letters|BattleTechWiki:Romanization|:Category:Romanization}}
{{See also|BattleIntelligence:Naming conventions (use English)#Modified letters|BattleIntelligence:Romanization|:Category:Romanization}}


Names and terms originally written using a non-[[Latin script]]—such as the [[Greek alphabet]], the [[Cyrillic alphabet]], or [[Chinese characters]]—must be [[romanized]] for English-language use. If a particular romanization of the subject's name is [[BattleTechWiki:Article titles#Use commonly recognizable names|most common]] in English ({{xt|Tchaikovsky}}, {{xt|Chiang Kai-shek}}), that form should be used. Otherwise, the romanization of names should adhere to a particular widely used system for the language in question ({{xt|Aleksandr Tymoczko}}, {{xt|Wang Yanhong}}).  
Names and terms originally written using a non-[[Latin script]]—such as the [[Greek alphabet]], the [[Cyrillic alphabet]], or [[Chinese characters]]—must be [[romanized]] for English-language use. If a particular romanization of the subject's name is [[BattleIntelligence:Article titles#Use commonly recognizable names|most common]] in English ({{xt|Tchaikovsky}}, {{xt|Chiang Kai-shek}}), that form should be used. Otherwise, the romanization of names should adhere to a particular widely used system for the language in question ({{xt|Aleksandr Tymoczko}}, {{xt|Wang Yanhong}}).  


The use of [[diacritic]]s in foreign words is neither encouraged nor discouraged. Use generally depends on whether they appear in reliable English-language sources, though with some additional constraints imposed by site guidelines. Provide [[BattleTechWiki:Redirect#Alternative names and languages|redirects]] from alternative forms that include or exclude diacritics.
The use of [[diacritic]]s in foreign words is neither encouraged nor discouraged. Use generally depends on whether they appear in reliable English-language sources, though with some additional constraints imposed by site guidelines. Provide [[BattleIntelligence:Redirect#Alternative names and languages|redirects]] from alternative forms that include or exclude diacritics.


Proper names in languages written using the [[Latin alphabet]] can include letters with diacritics, [[Typographic ligature|ligatures]], and other characters that are not commonly used in contemporary English. BattleTechWiki normally retains these special characters, except where there is a well-established English spelling that replaces them with English standard letters. Examples:
Proper names in languages written using the [[Latin alphabet]] can include letters with diacritics, [[Typographic ligature|ligatures]], and other characters that are not commonly used in contemporary English. BattleIntelligence normally retains these special characters, except where there is a well-established English spelling that replaces them with English standard letters. Examples:
*The name of the article on Hungarian mathematician [[Paul Erdős]] is spelt with the [[double acute accent]], and the alternative spellings ''Paul Erdos'' and ''Paul Erdös'' redirect to that article.
*The name of the article on Hungarian mathematician [[Paul Erdős]] is spelt with the [[double acute accent]], and the alternative spellings ''Paul Erdos'' and ''Paul Erdös'' redirect to that article.
*Similarly, the name of the article on the Nordic god [[Ægir]] is so spelt, with redirects from the ligature-free form [[Aegir]] and the Swedish spelling [[Ägir]].
*Similarly, the name of the article on the Nordic god [[Ægir]] is so spelt, with redirects from the ligature-free form [[Aegir]] and the Swedish spelling [[Ägir]].
*However, the region of Spain named Aragón in Spanish and Aragó in Catalan is given as [[Aragon]], without the accent, as this is the established English name. Non-English forms with diacritics appear in the article's lead section.
*However, the region of Spain named Aragón in Spanish and Aragó in Catalan is given as [[Aragon]], without the accent, as this is the established English name. Non-English forms with diacritics appear in the article's lead section.
Use of diacritics is determined on a topic-by-topic basis; a [[BattleTechWiki:Consensus#Levels of consensus|small group of editors]] cannot prohibit or require the use of diacritics within a given class of articles.
Use of diacritics is determined on a topic-by-topic basis; a [[BattleIntelligence:Consensus#Levels of consensus|small group of editors]] cannot prohibit or require the use of diacritics within a given class of articles.


Spell a name consistently in the title and the text of an article. {{crossref|(Relevant policy: [[BattleTechWiki:Article titles]]; see also [[BattleTechWiki:Naming conventions (use English)]].)}} For a foreign name, phrase, or word, adopt the spelling most commonly used in English-language [[BattleTechWiki:Verifiability#Reliable sources|reliable sources]], including but not limited to those already cited in the article. For punctuation of compounded forms, see relevant guidelines in {{section link||Punctuation}}.
Spell a name consistently in the title and the text of an article. {{crossref|(Relevant policy: [[BattleIntelligence:Article titles]]; see also [[BattleIntelligence:Naming conventions (use English)]].)}} For a foreign name, phrase, or word, adopt the spelling most commonly used in English-language [[BattleIntelligence:Verifiability#Reliable sources|reliable sources]], including but not limited to those already cited in the article. For punctuation of compounded forms, see relevant guidelines in {{section link||Punctuation}}.


A non-English [[Proper and common nouns|proper name]] should generally not be italicized, unless it would be for some other reason; this is most commonly when it is the [[BattleTechWiki:Manual of Style/Titles of works#FOREIGNTITLE|title of a major published work]], as in [[Les Liaisons dangereuses|{{xt|Les Liaisons dangereuses}}]]; or when it is being compared in a [[BattleTechWiki:Manual of Style/Text formatting#Words as words|words-as-words]] manner to another name for the same subject.
A non-English [[Proper and common nouns|proper name]] should generally not be italicized, unless it would be for some other reason; this is most commonly when it is the [[BattleIntelligence:Manual of Style/Titles of works#FOREIGNTITLE|title of a major published work]], as in [[Les Liaisons dangereuses|{{xt|Les Liaisons dangereuses}}]]; or when it is being compared in a [[BattleIntelligence:Manual of Style/Text formatting#Words as words|words-as-words]] manner to another name for the same subject.


Sometimes usage will be influenced by other guidelines, such as {{section link||National varieties of English}}, which may lead to different choices in different articles.
Sometimes usage will be influenced by other guidelines, such as {{section link||National varieties of English}}, which may lead to different choices in different articles.
Line 1,609: Line 1,609:
*For non-English characters that resemble single quotation marks and apostrophes, see {{section link||Foreign characters that resemble apostrophes}}.
*For non-English characters that resemble single quotation marks and apostrophes, see {{section link||Foreign characters that resemble apostrophes}}.
*For actual non-English quotation characters, see {{section link||Quotation characters}}.
*For actual non-English quotation characters, see {{section link||Quotation characters}}.
*For capitalization in foreign-language work titles, see {{section link|BattleTechWiki:Manual of Style/Titles#Capitalization in foreign-language titles}}.
*For capitalization in foreign-language work titles, see {{section link|BattleIntelligence:Manual of Style/Titles#Capitalization in foreign-language titles}}.
*For [[interlinear gloss]]es and their particular uses of small-caps (and italics and single quotes), see {{section link|BattleTechWiki:Manual of Style/Text formatting#All caps and small caps}}.
*For [[interlinear gloss]]es and their particular uses of small-caps (and italics and single quotes), see {{section link|BattleIntelligence:Manual of Style/Text formatting#All caps and small caps}}.


===Technical language<span id="JARGON"></span>===
===Technical language<span id="JARGON"></span>===
{{Shortcut|MOS:JARGON}}
{{Shortcut|MOS:JARGON}}
{{redirect|BattleTechWiki:Jargon|an explanation of jargon used on BattleTechWiki|BattleTechWiki:Glossary}}
{{redirect|BattleIntelligence:Jargon|an explanation of jargon used on BattleIntelligence|BattleIntelligence:Glossary}}
{{See also|BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not a manual, guidebook, textbook, or scientific journal|BattleTechWiki:Make technical articles understandable}}
{{See also|BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not a manual, guidebook, textbook, or scientific journal|BattleIntelligence:Make technical articles understandable}}


Some topics are intrinsically technical, but editors should try to make them understandable to as many readers as possible. Minimize [[jargon]], or at least explain it or tag it using {{tlx|Technical}} or {{tlx|Technical-statement}} for other editors to fix. For unavoidably technical articles, a separate introductory article (like [[Introduction to general relativity]]) may be the best solution.
Some topics are intrinsically technical, but editors should try to make them understandable to as many readers as possible. Minimize [[jargon]], or at least explain it or tag it using {{tlx|Technical}} or {{tlx|Technical-statement}} for other editors to fix. For unavoidably technical articles, a separate introductory article (like [[Introduction to general relativity]]) may be the best solution.


Avoid excessive ''wikilinking'' (linking within BattleTechWiki) as a substitute for parenthetic explanations such as the one in this sentence. Do not introduce new and specialized words simply to teach them to the reader when more common alternatives will do.  
Avoid excessive ''wikilinking'' (linking within BattleIntelligence) as a substitute for parenthetic explanations such as the one in this sentence. Do not introduce new and specialized words simply to teach them to the reader when more common alternatives will do.  


When the notions named by jargon are too complex to explain concisely in a few parenthetical words, [[BattleTechWiki:Make technical articles understandable#Write one level down|write one level down]]. For example, consider adding a brief background section with {{tlx|main}} tags pointing to the full treatment article(s) of the prerequisite notions; this approach is practical only when the prerequisite concepts are central to the exposition of the article's main topic and when such prerequisites are not too numerous. Short articles, such as [[BattleTechWiki:Stub|stubs]], generally do not have such sections.
When the notions named by jargon are too complex to explain concisely in a few parenthetical words, [[BattleIntelligence:Make technical articles understandable#Write one level down|write one level down]]. For example, consider adding a brief background section with {{tlx|main}} tags pointing to the full treatment article(s) of the prerequisite notions; this approach is practical only when the prerequisite concepts are central to the exposition of the article's main topic and when such prerequisites are not too numerous. Short articles, such as [[BattleIntelligence:Stub|stubs]], generally do not have such sections.


{{crossref|printworthy=y|For italicization and other markup of introduced terms, see: {{section link|BattleTechWiki:Manual of Style/Text formatting#Words as words}}.}}
{{crossref|printworthy=y|For italicization and other markup of introduced terms, see: {{section link|BattleIntelligence:Manual of Style/Text formatting#Words as words}}.}}


===Geographical items===
===Geographical items===
{{Shortcut|MOS:GEO|MOS:PLACE}}
{{Shortcut|MOS:GEO|MOS:PLACE}}
{{See also|BattleTechWiki:Naming conventions (geographic names)|BattleTechWiki:Manual of Style/Abbreviations#Special considerations}}
{{See also|BattleIntelligence:Naming conventions (geographic names)|BattleIntelligence:Manual of Style/Abbreviations#Special considerations}}


<section begin="MOS:GEO" />'''Geographical''' or '''place names''' are the nouns used to refer to specific places and geographic features. These names often give rise to conflict, because the same places are called different things by different peoples speaking different languages. Many place names have a historical context that should be preserved, but common sense should prevail. There can be few places that have not been parts of more than one culture or have had only one name. As proper nouns, all such place names (but not terms for types of places) [[BattleTechWiki:Manual of Style/Capital letters#Place names|have major words capitalized]].
<section begin="MOS:GEO" />'''Geographical''' or '''place names''' are the nouns used to refer to specific places and geographic features. These names often give rise to conflict, because the same places are called different things by different peoples speaking different languages. Many place names have a historical context that should be preserved, but common sense should prevail. There can be few places that have not been parts of more than one culture or have had only one name. As proper nouns, all such place names (but not terms for types of places) [[BattleIntelligence:Manual of Style/Capital letters#Place names|have major words capitalized]].


A place should generally be referred to consistently by the same name as in the title of its article {{crossref|(see [[BattleTechWiki:Naming conventions (geographic names)]])}}. An exception may be made when there is a widely accepted historical English name appropriate to the given context. In cases where such a historical name is used, it should be followed by the modern name in round brackets (parentheses) on the first occurrence of the name in applicable sections of the article. This resembles linking; it should not be done to the detriment of style. On the other hand, it is probably better to provide such a variant too often than too rarely. If more than one historical name is applicable for a given context, the other names should be added after the modern English name, that is: "historical name (modern name, other historical names)".
A place should generally be referred to consistently by the same name as in the title of its article {{crossref|(see [[BattleIntelligence:Naming conventions (geographic names)]])}}. An exception may be made when there is a widely accepted historical English name appropriate to the given context. In cases where such a historical name is used, it should be followed by the modern name in round brackets (parentheses) on the first occurrence of the name in applicable sections of the article. This resembles linking; it should not be done to the detriment of style. On the other hand, it is probably better to provide such a variant too often than too rarely. If more than one historical name is applicable for a given context, the other names should be added after the modern English name, that is: "historical name (modern name, other historical names)".


This is an English-language encyclopedia, so established English names are preferred if they exist, and spellings in non-English alphabets should always be transcribed into the Roman alphabet. In general, other articles should refer to places by the names which are used in the articles on those places, according to the rules described at [[BattleTechWiki:Naming conventions (geographic names)]]. If a different name is appropriate in a given historical or other context, then that may be used instead, although it is normal to follow the first occurrence of such a name with the standard modern name in parentheses.
This is an English-language encyclopedia, so established English names are preferred if they exist, and spellings in non-English alphabets should always be transcribed into the Roman alphabet. In general, other articles should refer to places by the names which are used in the articles on those places, according to the rules described at [[BattleIntelligence:Naming conventions (geographic names)]]. If a different name is appropriate in a given historical or other context, then that may be used instead, although it is normal to follow the first occurrence of such a name with the standard modern name in parentheses.


Names in languages with no particular present-day or historical ties to the place in question (English excepted, of course) should {{em|not}} be listed as alternatives.
Names in languages with no particular present-day or historical ties to the place in question (English excepted, of course) should {{em|not}} be listed as alternatives.
Line 1,640: Line 1,640:


==Media files==
==Media files==
{{See also|BattleTechWiki:Creation and usage of media files}}
{{See also|BattleIntelligence:Creation and usage of media files}}


===Images===
===Images===
{{Shortcut|MOS:IM}}
{{Shortcut|MOS:IM}}
{{Main|BattleTechWiki:Manual of Style/Images}}
{{Main|BattleIntelligence:Manual of Style/Images}}
{{See also|BattleTechWiki:Manual of Style/Accessibility#Images|BattleTechWiki:Image use policy|BattleTechWiki:Picture tutorial}}
{{See also|BattleIntelligence:Manual of Style/Accessibility#Images|BattleIntelligence:Image use policy|BattleIntelligence:Picture tutorial}}


*Each image should be inside the level{{nbs}}2 section to which it relates, within the section defined by the most recent <code>==Heading==</code> delimited by two equal signs, or at the top of the lead section. Do not place images immediately above section headings.
*Each image should be inside the level{{nbs}}2 section to which it relates, within the section defined by the most recent <code>==Heading==</code> delimited by two equal signs, or at the top of the lead section. Do not place images immediately above section headings.
*Avoid [[BattleTechWiki:Sandwich|sandwiching text]] horizontally between two images that face each other, and between an image and an infobox or similar.
*Avoid [[BattleIntelligence:Sandwich|sandwiching text]] horizontally between two images that face each other, and between an image and an infobox or similar.
*It is often preferable to place images of people so they "look" toward the text. Do not achieve this by reversing the image.<!-- Can create a false presentation e.g., by reversing the location of scars or other features. -->
*It is often preferable to place images of people so they "look" toward the text. Do not achieve this by reversing the image.<!-- Can create a false presentation e.g., by reversing the location of scars or other features. -->
*Any [[BattleTechWiki:Picture tutorial#Galleries|galleries]] should comply with {{section link|BattleTechWiki:Image use policy|Image galleries}}. Consider [[BattleTechWiki:Wikimedia sister projects#Where to place links|linking to additional images on Commons]] instead.
*Any [[BattleIntelligence:Picture tutorial#Galleries|galleries]] should comply with {{section link|BattleIntelligence:Image use policy|Image galleries}}. Consider [[BattleIntelligence:Wikimedia sister projects#Where to place links|linking to additional images on Commons]] instead.
*Avoid referring to images as being to the left, the right, above or below, because image placement varies with platform, and is meaningless to people using screen readers; instead, use captions to identify images.
*Avoid referring to images as being to the left, the right, above or below, because image placement varies with platform, and is meaningless to people using screen readers; instead, use captions to identify images.
*An image's {{para|alt}} text takes the image's place for those who are unable to see the image. See [[BattleTechWiki:Manual of Style/Accessibility/Alternative text for images]].
*An image's {{para|alt}} text takes the image's place for those who are unable to see the image. See [[BattleIntelligence:Manual of Style/Accessibility/Alternative text for images]].


===Other media files===
===Other media files===
{{See also|BattleTechWiki:Videos}}
{{See also|BattleIntelligence:Videos}}


Other media files include video and audio files. Style recommendations for such files largely follow recommendations for image files (as far as applicable).
Other media files include video and audio files. Style recommendations for such files largely follow recommendations for image files (as far as applicable).


===Avoid using images to convey text<span id="Avoid entering textual information as images"></span>===
===Avoid using images to convey text<span id="Avoid entering textual information as images"></span>===
{{See also|BattleTechWiki:Manual of Style/Accessibility#Text}}
{{See also|BattleIntelligence:Manual of Style/Accessibility#Text}}
{{Shortcut|MOS:TEXTASIMAGES}}
{{Shortcut|MOS:TEXTASIMAGES}}


Textual information should almost always be entered as text rather than as an image. True text can be colored and adjusted with [[Cascading Style Sheets|CSS]] tags and templates, but text in images cannot be. Images are not searchable, are slower to download, and are unlikely to be read as text by devices for the visually impaired. Any important textual information in an image should also appear in the image's alt text, caption, or other nearby text.
Textual information should almost always be entered as text rather than as an image. True text can be colored and adjusted with [[Cascading Style Sheets|CSS]] tags and templates, but text in images cannot be. Images are not searchable, are slower to download, and are unlikely to be read as text by devices for the visually impaired. Any important textual information in an image should also appear in the image's alt text, caption, or other nearby text.


For entering textual information as audio, see [[BattleTechWiki:WikiProject Spoken BattleTechWiki]].
For entering textual information as audio, see [[BattleIntelligence:WikiProject Spoken BattleIntelligence]].


===Captions===
===Captions===
{{Shortcut|MOS:CAPTION}}
{{Shortcut|MOS:CAPTION}}
{{Main|BattleTechWiki:Manual of Style/Captions}}
{{Main|BattleIntelligence:Manual of Style/Captions}}


Photographs and other graphics should have captions, unless they are unambiguous depictions of the subject of the article or when they are "self-captioning" images (such as reproductions of album or book covers). In a biography article no caption is necessary for a portrait of the subject pictured alone, but one might be used to give the year, the subject's age, or other circumstances of the portrait along with the name of the subject.
Photographs and other graphics should have captions, unless they are unambiguous depictions of the subject of the article or when they are "self-captioning" images (such as reproductions of album or book covers). In a biography article no caption is necessary for a portrait of the subject pictured alone, but one might be used to give the year, the subject's age, or other circumstances of the portrait along with the name of the subject.
Line 1,682: Line 1,682:
==Bulleted and numbered lists==
==Bulleted and numbered lists==
{{Shortcut|MOS:LISTBULLET|MOS:LISTNUMBERED}}
{{Shortcut|MOS:LISTBULLET|MOS:LISTNUMBERED}}
{{Main|BattleTechWiki:Manual of Style/Lists|BattleTechWiki:Manual of Style/Embedded lists}}
{{Main|BattleIntelligence:Manual of Style/Lists|BattleIntelligence:Manual of Style/Embedded lists}}
{{further information|Help:List}}
{{further information|Help:List}}
*Do not use lists if a passage is read easily as plain paragraphs.
*Do not use lists if a passage is read easily as plain paragraphs.
*Use proper wiki markup- or template-based list code {{crossref|(see [[BattleTechWiki:Manual of Style/Lists]] and [[Help:List]])}}.
*Use proper wiki markup- or template-based list code {{crossref|(see [[BattleIntelligence:Manual of Style/Lists]] and [[Help:List]])}}.
*Do not leave blank lines between items in a bulleted or numbered list unless there is a reason to do so, since this causes the Wiki software to interpret each item as beginning a new list.
*Do not leave blank lines between items in a bulleted or numbered list unless there is a reason to do so, since this causes the Wiki software to interpret each item as beginning a new list.
**Indents (such as this) are permitted if the elements are [[BattleTechWiki:Manual of Style/Embedded lists#"Children" (i.e., indentation)|"child" items]].
**Indents (such as this) are permitted if the elements are [[BattleIntelligence:Manual of Style/Embedded lists#"Children" (i.e., indentation)|"child" items]].
*Use numbers rather than bullets only if:
*Use numbers rather than bullets only if:
**a need to refer to the elements by number may arise;
**a need to refer to the elements by number may arise;
Line 1,700: Line 1,700:
==Links==
==Links==
===Wikilinks===
===Wikilinks===
{{Main|BattleTechWiki:Manual of Style/Linking}}
{{Main|BattleIntelligence:Manual of Style/Linking}}
{{See also|Help:Link}}
{{See also|Help:Link}}


Line 1,707: Line 1,707:
'''Linking to sections''': A hash sign&nbsp;(<code>#</code>) followed by the appropriate heading will lead to a relevant part of a page. For example, <code><nowiki>[[Apostrophe#Use in non-English names]]</nowiki></code> links to a particular section of the article [[Apostrophe]].
'''Linking to sections''': A hash sign&nbsp;(<code>#</code>) followed by the appropriate heading will lead to a relevant part of a page. For example, <code><nowiki>[[Apostrophe#Use in non-English names]]</nowiki></code> links to a particular section of the article [[Apostrophe]].


'''Initial capitalization''': BattleTechWiki's [[MediaWiki]] software does not require that wikilinks begin with an upper-case character. Capitalize the first letter only where this is naturally called for, or when specifically referring to the linked article by its name (see also related rule for [[BattleTechWiki:Manual of Style/Text formatting#Uses of italics that are specific to BattleTechWiki|italics in cross-references]]): {{xt|[[Snake]]s are often [[venomous]], but [[lizard]]s only rarely {{crossreference|(see [[Poison]])}}.}}
'''Initial capitalization''': BattleIntelligence's [[MediaWiki]] software does not require that wikilinks begin with an upper-case character. Capitalize the first letter only where this is naturally called for, or when specifically referring to the linked article by its name (see also related rule for [[BattleIntelligence:Manual of Style/Text formatting#Uses of italics that are specific to BattleIntelligence|italics in cross-references]]): {{xt|[[Snake]]s are often [[venomous]], but [[lizard]]s only rarely {{crossreference|(see [[Poison]])}}.}}


'''Check links''': Ensure the destination is the intended one; many dictionary words lead to disambiguation pages and not to complete or well-chosen articles.
'''Check links''': Ensure the destination is the intended one; many dictionary words lead to disambiguation pages and not to complete or well-chosen articles.


===External links===
===External links===
{{Main|BattleTechWiki:External links}}
{{Main|BattleIntelligence:External links}}


External links should not normally be used in the body of an article. Instead, articles can include an ''External links'' section at the end, pointing to further information outside BattleTechWiki as distinct from citing sources. The standard format is a primary heading, <code>==External links==</code>, followed by a bulleted list of links. Identify the link and briefly indicate its relevance to the article. For example:
External links should not normally be used in the body of an article. Instead, articles can include an ''External links'' section at the end, pointing to further information outside BattleIntelligence as distinct from citing sources. The standard format is a primary heading, <code>==External links==</code>, followed by a bulleted list of links. Identify the link and briefly indicate its relevance to the article. For example:


{{Block indent|{{plain list|
{{Block indent|{{plain list|
Line 1,730: Line 1,730:
Where appropriate, use [[:Category:External link templates|external link templates]] such as {{tlx|Official website}} and {{tlx|URL}}.
Where appropriate, use [[:Category:External link templates|external link templates]] such as {{tlx|Official website}} and {{tlx|URL}}.


Add external links with discretion; BattleTechWiki is [[BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not a mirror or a repository of links, images, or media files|not a link repository]].
Add external links with discretion; BattleIntelligence is [[BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not a mirror or a repository of links, images, or media files|not a link repository]].


==Miscellaneous==
==Miscellaneous==
Line 1,738: Line 1,738:
Other things being equal, keep [[Help:Wiki markup|markup]] simple. This makes wikitext easier to understand and edit, and the results seen by the reader more predictable. Use HTML and CSS markup sparingly. See: [[KISS principle]].
Other things being equal, keep [[Help:Wiki markup|markup]] simple. This makes wikitext easier to understand and edit, and the results seen by the reader more predictable. Use HTML and CSS markup sparingly. See: [[KISS principle]].


In general, wikitext formatting is considered easier to use than HTML and wikitext is preferred if there are equivalents; see [[Help:HTML in wikitext]]. [[BattleTechWiki:HTML 5#Obsolete elements and attributes|Obsolete elements and attributes]] should be updated or removed. There are many templates that allow HTML markup to be used without putting it in articles directly, such as {{tl|em}} (see [[MOS:EMPHASIS]]) and {{tl|strong}} (see [[MOS:BOLD]]).
In general, wikitext formatting is considered easier to use than HTML and wikitext is preferred if there are equivalents; see [[Help:HTML in wikitext]]. [[BattleIntelligence:HTML 5#Obsolete elements and attributes|Obsolete elements and attributes]] should be updated or removed. There are many templates that allow HTML markup to be used without putting it in articles directly, such as {{tl|em}} (see [[MOS:EMPHASIS]]) and {{tl|strong}} (see [[MOS:BOLD]]).


An [[Character entity reference|HTML character entity]] is sometimes better than the equivalent Unicode character, which may be difficult to identify in edit mode; for example, <code>&amp;Alpha;</code> is explicit whereas <code>&Alpha;</code> (the upper-case form of Greek <code>α</code>) may be misidentified as the Latin <code>A</code>.
An [[Character entity reference|HTML character entity]] is sometimes better than the equivalent Unicode character, which may be difficult to identify in edit mode; for example, <code>&amp;Alpha;</code> is explicit whereas <code>&Alpha;</code> (the upper-case form of Greek <code>α</code>) may be misidentified as the Latin <code>A</code>.


===Formatting issues===
===Formatting issues===
{{See also|BattleTechWiki:Manual of Style/Text formatting}}
{{See also|BattleIntelligence:Manual of Style/Text formatting}}


Modifications in font size, blank space, and color {{crossref|(see {{section link||Color coding}})}} are an issue for the BattleTechWiki site-wide [[Cascading Style Sheets|style sheet]] and should be reserved for special cases only.
Modifications in font size, blank space, and color {{crossref|(see {{section link||Color coding}})}} are an issue for the BattleIntelligence site-wide [[Cascading Style Sheets|style sheet]] and should be reserved for special cases only.


Typically, the use of custom font styles:
Typically, the use of custom font styles:
Line 1,755: Line 1,755:


====Color coding====
====Color coding====
{{Main|BattleTechWiki:Manual of Style/Accessibility#Color}}{{Shortcut|MOS:COLORCODING}}
{{Main|BattleIntelligence:Manual of Style/Accessibility#Color}}{{Shortcut|MOS:COLORCODING}}


Do not use color {{em|alone}} to mark differences in text: they may be invisible to people with [[color blindness]] and useless in black-and-white printouts or displays.
Do not use color {{em|alone}} to mark differences in text: they may be invisible to people with [[color blindness]] and useless in black-and-white printouts or displays.
Line 1,765: Line 1,765:
====Indentation<span class="anchor" id="INDENT"></span><span class="anchor" id="Indent"></span><span class="anchor" id="indenting"></span>====
====Indentation<span class="anchor" id="INDENT"></span><span class="anchor" id="Indent"></span><span class="anchor" id="indenting"></span>====
{{Shortcut|MOS:INDENT}}
{{Shortcut|MOS:INDENT}}
{{Main|BattleTechWiki:Manual of Style/Accessibility#Indentation}}
{{Main|BattleIntelligence:Manual of Style/Accessibility#Indentation}}


Do not use quotation templates to indent non-quotations. Various templates are available for indentation, including {{tlx|block indent}} to indent an entire block and {{tlx|in5}} to indent inline.
Do not use quotation templates to indent non-quotations. Various templates are available for indentation, including {{tlx|block indent}} to indent an entire block and {{tlx|in5}} to indent inline.


Do not use <code>:</code> ([[description list]] markup) to indent text in articles, even though it is common on talk pages. It causes accessibility problems and outputs invalid HTML. {{Crossref|See {{section link|BattleTechWiki:Manual of Style/Accessibility#Indentation}} for alternatives.}}
Do not use <code>:</code> ([[description list]] markup) to indent text in articles, even though it is common on talk pages. It causes accessibility problems and outputs invalid HTML. {{Crossref|See {{section link|BattleIntelligence:Manual of Style/Accessibility#Indentation}} for alternatives.}}


===Controlling line breaks<span id="Non-breaking spaces"></span>===
===Controlling line breaks<span id="Non-breaking spaces"></span>===
Line 1,803: Line 1,803:
{{Shortcut|MOS:SCROLL|MOS:COLLAPSE|MOS:DONTHIDE}}
{{Shortcut|MOS:SCROLL|MOS:COLLAPSE|MOS:DONTHIDE}}
{{Redirect|BTW:COLLAPSE|the guideline on collapsing off-topic talk page discussions|BTW:TALKOFFTOPIC}}
{{Redirect|BTW:COLLAPSE|the guideline on collapsing off-topic talk page discussions|BTW:TALKOFFTOPIC}}
{{See also|BattleTechWiki:Manual of Style/Accessibility#Users with limited CSS or JavaScript support}}
{{See also|BattleIntelligence:Manual of Style/Accessibility#Users with limited CSS or JavaScript support}}


[[Help:Scrolling list|Scrolling lists]], and collapsible templates that toggle text display between ''hide'' and ''show'', can interfere with readers' ability to access our content. Such mechanisms should not be used to conceal "[[BattleTechWiki:Spoiler|spoiler]]" information. Templates should [[BattleTechWiki:Template namespace#Guidelines|not normally be used to store article text]] at all, as it interferes with editors' ability to find and edit it.
[[Help:Scrolling list|Scrolling lists]], and collapsible templates that toggle text display between ''hide'' and ''show'', can interfere with readers' ability to access our content. Such mechanisms should not be used to conceal "[[BattleIntelligence:Spoiler|spoiler]]" information. Templates should [[BattleIntelligence:Template namespace#Guidelines|not normally be used to store article text]] at all, as it interferes with editors' ability to find and edit it.


When such features are used, take care that the content will still be [[BattleTechWiki:Manual of Style/Accessibility#Users with limited CSS or JavaScript support|accessible on devices that do not support JavaScript or CSS]], and to the greater than 60% of BattleTechWiki readers who use the [[Help:Mobile access|mobile version of the site]], which has a limited set of features and does not support collapsing (any collapsible templates will either be automatically uncollapsed or hidden entirely). Mobile ability to access the content in question is easy to test with the "Mobile view" link at the bottom of each page.
When such features are used, take care that the content will still be [[BattleIntelligence:Manual of Style/Accessibility#Users with limited CSS or JavaScript support|accessible on devices that do not support JavaScript or CSS]], and to the greater than 60% of BattleIntelligence readers who use the [[Help:Mobile access|mobile version of the site]], which has a limited set of features and does not support collapsing (any collapsible templates will either be automatically uncollapsed or hidden entirely). Mobile ability to access the content in question is easy to test with the "Mobile view" link at the bottom of each page.


{{em|Collapsible templates should not conceal article content by default upon page loading.}} This includes [[BattleTechWiki:Citing sources#Footnotes|reference lists]], [[BattleTechWiki:Manual of Style/Tables|tables]] and [[BattleTechWiki:Manual of Style/Embedded lists|lists]] of article content, [[BattleTechWiki:Image use policy#Image galleries|image galleries]], and [[BattleTechWiki:Manual of Style/Captions|image captions]].
{{em|Collapsible templates should not conceal article content by default upon page loading.}} This includes [[BattleIntelligence:Citing sources#Footnotes|reference lists]], [[BattleIntelligence:Manual of Style/Tables|tables]] and [[BattleIntelligence:Manual of Style/Embedded lists|lists]] of article content, [[BattleIntelligence:Image use policy#Image galleries|image galleries]], and [[BattleIntelligence:Manual of Style/Captions|image captions]].


When hiding content is desired, it must be done using the <code>collapsible</code> parameter of relevant templates, or manually-added CSS classes <code>mw-collapsed</code>, and <code>autocollapse</code> (see [[Help:Collapsing]]). Other methods of hiding content should not be used, as they may render content inaccessible to many users, such as those browsing BattleTechWiki with [[JavaScript]] disabled, browsing the mobile version, or using proxy services such as [[Google Web Light]].
When hiding content is desired, it must be done using the <code>collapsible</code> parameter of relevant templates, or manually-added CSS classes <code>mw-collapsed</code>, and <code>autocollapse</code> (see [[Help:Collapsing]]). Other methods of hiding content should not be used, as they may render content inaccessible to many users, such as those browsing BattleIntelligence with [[JavaScript]] disabled, browsing the mobile version, or using proxy services such as [[Google Web Light]].


Collapsed or auto-collapsing ''cells'' or ''sections'' may be used with tables if they simply repeat information covered in the main text (or are purely supplementary, e.g., several past years of statistics in collapsed tables for comparison with a table of uncollapsed current stats). Auto-collapsing is often a feature of [[BattleTechWiki:Categories, lists, and navigation templates#Navigation templates|navboxes]]. A few [[BattleTechWiki:Infobox|infoboxes]] also use pre-collapsed sections for infrequently accessed details. If information in a list, infobox, or other non-navigational content seems extraneous or trivial enough to inspire pre-collapsing it, consider raising a discussion on the article (or template) talk page about whether it should be [[BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not an indiscriminate collection of information|included at all]]. If the information is important and the concern is article density or length, consider [[BattleTechWiki:Manual of Style/Layout#Body sections|dividing the article into more sections]], integrating [[BattleTechWiki:Manual of Style/Trivia sections|unnecessarily list-formatted information]] into the article prose, or [[BattleTechWiki:Summary style|splitting the article]].
Collapsed or auto-collapsing ''cells'' or ''sections'' may be used with tables if they simply repeat information covered in the main text (or are purely supplementary, e.g., several past years of statistics in collapsed tables for comparison with a table of uncollapsed current stats). Auto-collapsing is often a feature of [[BattleIntelligence:Categories, lists, and navigation templates#Navigation templates|navboxes]]. A few [[BattleIntelligence:Infobox|infoboxes]] also use pre-collapsed sections for infrequently accessed details. If information in a list, infobox, or other non-navigational content seems extraneous or trivial enough to inspire pre-collapsing it, consider raising a discussion on the article (or template) talk page about whether it should be [[BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not an indiscriminate collection of information|included at all]]. If the information is important and the concern is article density or length, consider [[BattleIntelligence:Manual of Style/Layout#Body sections|dividing the article into more sections]], integrating [[BattleIntelligence:Manual of Style/Trivia sections|unnecessarily list-formatted information]] into the article prose, or [[BattleIntelligence:Summary style|splitting the article]].


===Invisible comments===
===Invisible comments===
{{Shortcut|MOS:COMMENT}}
{{Shortcut|MOS:COMMENT}}
{{redirect|BTW:COMMENT|the expression of personal opinions in articles|BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not a publisher of original thought}}
{{redirect|BTW:COMMENT|the expression of personal opinions in articles|BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not a publisher of original thought}}
{{for|invisible control characters|BattleTechWiki:Manual of Style/Text formatting#Private Use Area and invisible formatting characters}}
{{for|invisible control characters|BattleIntelligence:Manual of Style/Text formatting#Private Use Area and invisible formatting characters}}
{{Main|BattleTechWiki:Manual of Style/Hidden text}}
{{Main|BattleIntelligence:Manual of Style/Hidden text}}


Editors use "invisible" comments{{snd}}not shown in the rendered page seen by readers of the article, but visible in the source editing mode when an editor opens the article for editing{{snd}}to communicate with one another.
Editors use "invisible" comments{{snd}}not shown in the rendered page seen by readers of the article, but visible in the source editing mode when an editor opens the article for editing{{snd}}to communicate with one another.
Line 1,831: Line 1,831:


===Pronunciation===
===Pronunciation===
{{Main|BattleTechWiki:Manual of Style/Pronunciation}}
{{Main|BattleIntelligence:Manual of Style/Pronunciation}}


'''Pronunciation''' in BattleTechWiki is indicated in the [[International Phonetic Alphabet]] (IPA). In most situations, for ease of understanding by the majority of readers and across variants of the language, [[Phonetic transcription#Narrow versus broad transcription|quite broad]] IPA transcriptions are best for English pronunciations. See [[Help:IPA/English]] and [[Help:IPA]] (general) for keys, and {{tlx|IPA}} for templates that link to these keys. For English pronunciations, [[Help:Pronunciation respelling key|pronunciation respellings]] may be used {{em|in addition to}} the IPA.
'''Pronunciation''' in BattleIntelligence is indicated in the [[International Phonetic Alphabet]] (IPA). In most situations, for ease of understanding by the majority of readers and across variants of the language, [[Phonetic transcription#Narrow versus broad transcription|quite broad]] IPA transcriptions are best for English pronunciations. See [[Help:IPA/English]] and [[Help:IPA]] (general) for keys, and {{tlx|IPA}} for templates that link to these keys. For English pronunciations, [[Help:Pronunciation respelling key|pronunciation respellings]] may be used {{em|in addition to}} the IPA.


==See also==
==See also==
*[[BattleTechWiki:Editing policy|Editing policy]] – explains BattleTechWiki's general philosophy of editing
*[[BattleIntelligence:Editing policy|Editing policy]] – explains BattleIntelligence's general philosophy of editing
*[[BattleTechWiki:What BattleTechWiki is not#BattleTechWiki is not a manual, guidebook, textbook, or scientific journal|BattleTechWiki is not a manual, guidebook, textbook, or scientific journal]]{{snd}}we write for a general, not technical, readership as much as we can
*[[BattleIntelligence:What BattleIntelligence is not#BattleIntelligence is not a manual, guidebook, textbook, or scientific journal|BattleIntelligence is not a manual, guidebook, textbook, or scientific journal]]{{snd}}we write for a general, not technical, readership as much as we can
*[[Help:Introduction to the Manual of Style|Manual of Style tutorial]]{{snd}}a quick introduction to the style guide for articles
*[[Help:Introduction to the Manual of Style|Manual of Style tutorial]]{{snd}}a quick introduction to the style guide for articles
*[[Help:Introduction to the Manual of Style/Manual of Style quiz|Manual of Style quiz]]{{snd}}test your Manual of Style knowledge
*[[Help:Introduction to the Manual of Style/Manual of Style quiz|Manual of Style quiz]]{{snd}}test your Manual of Style knowledge
*[[BattleTechWiki:Styletips|Styletips]] – a list of advice for editors on writing style and formatting
*[[BattleIntelligence:Styletips|Styletips]] – a list of advice for editors on writing style and formatting
*[[BattleTechWiki:Manual of Style/Contents|Manual of Style Contents]] – guidelines for film, novels, biographies, military history, etc.
*[[BattleIntelligence:Manual of Style/Contents|Manual of Style Contents]] – guidelines for film, novels, biographies, military history, etc.
*[[BattleTechWiki:Identifying and using style guides|Identifying and using style guides]]{{snd}}an essay providing a summary of off-site style guides' influences on MoS and their uses as sources in BattleTechWiki articles
*[[BattleIntelligence:Identifying and using style guides|Identifying and using style guides]]{{snd}}an essay providing a summary of off-site style guides' influences on MoS and their uses as sources in BattleIntelligence articles
*[[BattleTechWiki:If MOS doesn't need a rule on something, then it needs to not have a rule on that thing]]{{snd}}resisting MOSbloat
*[[BattleIntelligence:If MOS doesn't need a rule on something, then it needs to not have a rule on that thing]]{{snd}}resisting MOSbloat


===Guidance===
===Guidance===
*[[BattleTechWiki:Annotated article|Annotated article]] – is a well-constructed sample article, with annotations
*[[BattleIntelligence:Annotated article|Annotated article]] – is a well-constructed sample article, with annotations
*[[BattleTechWiki:Article development|Article development]] – lists the ways in which you can help an article grow
*[[BattleIntelligence:Article development|Article development]] – lists the ways in which you can help an article grow
**[[BattleTechWiki:Basic copyediting|Basic copyediting]] – gives helpful advice on copy-editing
**[[BattleIntelligence:Basic copyediting|Basic copyediting]] – gives helpful advice on copy-editing
**[[BattleTechWiki:Writing better articles|Better articles]] – guidance on how to make articles better
**[[BattleIntelligence:Writing better articles|Better articles]] – guidance on how to make articles better
**[[BattleTechWiki:The perfect article|Perfect article]] – point-by-point guidance on what makes a great article
**[[BattleIntelligence:The perfect article|Perfect article]] – point-by-point guidance on what makes a great article
*[[BattleTechWiki:Avoiding common mistakes|Avoiding common mistakes]] – gives a list of common mistakes and how to avoid them
*[[BattleIntelligence:Avoiding common mistakes|Avoiding common mistakes]] – gives a list of common mistakes and how to avoid them
*[[BattleTechWiki:Be bold|Be bold]] – suggests a bold attitude toward page updates
*[[BattleIntelligence:Be bold|Be bold]] – suggests a bold attitude toward page updates
*[[BattleTechWiki:Citing sources|Citing sources]] – explains process and standards for citing references
*[[BattleIntelligence:Citing sources|Citing sources]] – explains process and standards for citing references
*[[Help:Editing|Editing]] – is a short primer on editing pages
*[[Help:Editing|Editing]] – is a short primer on editing pages
*[[Style guide]] – contains links to the style guides of some magazines and newspapers
*[[Style guide]] – contains links to the style guides of some magazines and newspapers
*[[Help:Wiki markup|Wiki markup]] – explains the codes and resources available for editing a page
*[[Help:Wiki markup|Wiki markup]] – explains the codes and resources available for editing a page
*[[BattleTechWiki:In versus of|BattleTechWiki:''in'' versus ''of'']] – proper use of ''in'' and ''of'' (or some alternatives, as ''from'' and ''on'')
*[[BattleIntelligence:In versus of|BattleIntelligence:''in'' versus ''of'']] – proper use of ''in'' and ''of'' (or some alternatives, as ''from'' and ''on'')


{{Manual of Style}}
{{Manual of Style}}
{{BattleTechWiki policies and guidelines}}
{{BattleIntelligence policies and guidelines}}


[[Category:Manual of Style| ]]
[[Category:Manual of Style| ]]

Latest revision as of 20:58, 30 April 2025


This Manual of Style (MoS or MOS) is the style manual for all BattleIntelligence articles (though provisions related to accessibility apply across the entire project, not just to articles). This primary page is supported by further detail pages. If any contradiction arises, this page has precedence.

Editors should write articles using straightforward, succinct, easily understood language and structure articles with consistent, reader-friendly layouts and formatting (which are detailed in this guide).

Where more than one style or format is acceptable under the MoS, one should be used consistently within an article and should not be changed without good reason. Edit warring over stylistic choices is unacceptable.

New content added to this page should directly address a persistently recurring style issue.

Retaining existing styles

Sometimes the MoS provides more than one acceptable style or gives no specific guidance. The principle that "When either of two styles is acceptable it is inappropriate for a BattleIntelligence editor to change from one style to another unless there is some substantial reason for the change."

Edit-warring over style, or enforcing optional style in a robot-like fashion without prior consensus, is never acceptable.

Unjustified changes from one acceptable, consistently-applied style in an article to a different style may generally be reverted. Seek opportunities for commonality to avoid disputes over style.

If you believe an alternative style would be more appropriate for a particular article, seek consensus by discussing this at the article's talk page or – if it raises an issue of more general application or with the MoS itself – at BattleIntelligence talk:Manual of Style. If a discussion does not result in consensus for the change at the article, continue to use the already-established style there. If discussion fails to reach a consensus regarding which of two or more competing styles to use at all, then default to the style that was used in the first post-stub version of the article in which one of the applicable styles appeared. (This fall-back position does not give unchallengable primacy to that particular style during consensus discussion, nor give the editor who imposed that earliest style any more say in the discussion.)

For retention of an article's established national variety of English (and potential reasons to change it), see § National varieties of English.

Article titles, sections, and headings

Article titles

A title should be a recognizable name or description of the topic, balancing the criteria of being natural, sufficiently precise, concise, and consistent with those of related articles.

For formatting guidance see the BattleIntelligence:Article titles § Article title format section, noting the following:

Subject both to the above and to BattleIntelligence:Article titles, the rest of the MoS, particularly § Punctuation, applies also to the title.

See also BattleIntelligence:Manual of Style/Titles of works, for cases where an article about a published work has a title that coincides with the work's title.

Section organization

An article's content should begin with an introductory lead section – a concise summary of the article – which is never divided into sections (see BattleIntelligence:Manual of Style/Lead section). The remainder of the article is typically divided into sections.

Infoboxes, images, and related content in the lead section must be right-aligned.

Certain standardized templates and wikicode that are not sections go at the very top of the article, before the content of the lead section, and in the following order:

If an article has at least four section headings, a navigable table of contents appears automatically, just after the lead.

If the topic of a section is covered in more detail in a dedicated article (see BattleIntelligence:Summary style), insert {{main|Article name}} or {{further|Article name}} immediately under the section heading.

As explained in detail in BattleIntelligence:Manual of Style/Layout § Standard appendices and footers, several kinds of material (mostly optional) may appear after the main body of the article, in the following order:

  • Books or other works created by the subject of the article, under a section heading "Works", "Publications", "Discography", "Filmography", etc. as appropriate (avoid "Bibliography", confusable with reference citations)
  • Internal links to related English BattleIntelligence articles, with section heading "See also"
  • Notes and references, with a section heading "Notes" or "References" (usually the latter), or a separate section for each in this order (see BattleIntelligence:Citing sources); avoid "Bibliography", confusable with the subject's works
  • Relevant books, articles, or other publications that have not been used as sources; use the section heading "Further reading"; be highly selective, as BattleIntelligence is not a bibliographic directory
  • Relevant and appropriate websites that have not been used as sources and do not appear in the earlier appendices, using the heading "External links", which may be made a subsection of "Further reading" (or such links can be integrated directly into the "Further reading" list instead); link templates for sister-project content also usually go at the top of this section when it is present (otherwise in the last section on the page)
  • The following final items never take section headings:

Stand-alone list articles have some additional layout considerations.

Section headings

Section headings should generally follow the guidance for article titles (above), and should be presented in sentence case (Template:FormattingError), not title case (Template:FormattingError).

The heading must be on its own line, with one blank line just before it; a blank line just after is optional and ignored (but do not use two blank lines, before or after, because that will add unwanted visible space).

For technical reasons, section headings should:

  • Be unique within a page, so that section links lead to the right place.
  • Not contain links, especially where only part of a heading is linked.
  • Not contain images or icons.
  • Not contain <math> markup.
  • Not contain citations or footnotes.
  • Not misuse description list markup (";") to create pseudo-headings.
  • Not contain template transclusions.

These technical restrictions are necessary to avoid technical complications and are not subject to override by local consensus.

As a matter of consistent style, section headings should:

These are broadly accepted community preferences.

An invisible comment on the same line must be inside the == == markup:

It is more usual practice to put such comments below the heading.

<section begin="heading links" />Before changing a heading, consider whether you might be breaking existing links to it.<section end="heading links" /> If there are many links to the old title, create an anchor with that title to ensure that these still work. Similarly, when linking to a section, leave an invisible comment at the heading of the target section, naming the linking articles, so that if the heading is later altered these can be fixed. For (a combined) example:

which will be saved in the article as:

The advantage of using {{subst:Anchor}}, or simply inserting the <span> tags directly, is that when edits are made to the section in the future, the anchor will not be included in page history entries as part of the section name. When {{Anchor}} is used directly, that undesirable behavior does occur. Note: if electing to insert the span directly, do not abbreviate it by using a self-closing tag, as in ==Implications<span id="Consequences" />==, since in HTML5 that XML-style syntax is valid only for certain tags, such as <br />. See BattleIntelligence:Manual of Style/Linking § Avoiding broken section links for further discussion.

Heading-like material

The above guidance about sentence case, redundancy, images, and questions also applies to headers of tables (and of table columns and rows). However, table headings can incorporate citations and may begin with, or be, numbers. Unlike page headings, table headers do not automatically generate link anchors. Aside from sentence case in glossaries, the heading advice also applies to the term entries in description lists. If using template-structured glossaries, terms will automatically have link anchors, but will not otherwise. Citations for description-list content go in the term or definition element, as needed.

National varieties of English

National varieties of English (for example, American English or British English) differ in vocabulary (elevator vs. lift ), spelling (center vs. centre), and occasionally grammar (see § Plurals, below). Articles such as English plurals and Comparison of American and British English provide information about such differences. The English BattleIntelligence prefers no national variety over others.

An article's date formatting (Template:FormattingError vs. Template:FormattingError) is also related to national varieties of English – see MOS:DATEFORMAT and especially MOS:DATETIES and MOS:DATEVAR.

Consistency within articles

Within a given article the conventions of one particular variety of English should be followed consistently. Exceptions include:

Opportunities for commonality

For an international encyclopedia, using vocabulary common to all varieties of English is preferable.

For assistance with specific terms, see Comparison of American and British English § Vocabulary, and American and British English spelling differences; most dictionaries also indicate regional terms.

Strong national ties to a topic

An article on a topic that has strong ties to a particular English-speaking nation should use the (formal, not colloquial) English of that nation. For example:

For topics with strong ties to Commonwealth of Nations countries and other former British territories, use Commonwealth English orthography, largely indistinguishable from British English in encyclopedic writing (excepting Canada, which uses a different orthography).

Retaining the existing variety

When an English variety's consistent usage has been established in an article, maintain it in the absence of consensus to the contrary. With few exceptions (e.g., when a topic has strong national ties or the change reduces ambiguity), there is no valid reason for changing from one acceptable option to another.

When no English variety has been established and discussion does not resolve the issue, use the variety found in the first post-stub revision that introduced an identifiable variety. The established variety in a given article can be documented by placing the appropriate variety of English template on its talk page.

An article should not be edited or renamed simply to switch from one variety of English to another. {{subst:uw-engvar}} may be placed on an editor's talk page to explain this.

Capital letters

BattleIntelligence article titles and section headings use sentence case, not title case; see BattleIntelligence:Article titles and § Section headings. For capitalization of list items, see § Bulleted and numbered lists. Other points concerning capitalization are summarized below. Full information can be found at BattleIntelligence:Manual of Style/Capital letters. The central point is that BattleIntelligence does not capitalize something unless it is consistently capitalized in a substantial majority of independent, reliable sources.

Capitalization of The

Generally, do not capitalize the word the in mid-sentence: Template:FormattingError, not Template:FormattingError. Conventional exceptions include certain proper names (Template:FormattingError) and most titles of creative works (Template:FormattingError – but be aware that the may not be part of the title itself, e.g., Template:FormattingError).

There are special considerations for: band names · institution names · nicknames · titles of works · trademarks.

Titles of works

The English-language titles of compositions (books and other print works, songs and other audio works, films and other visual media works, paintings and other artworks, etc.) are given in title case, in which every word is given an initial capital except for certain less important words (as detailed at BattleIntelligence:Manual of Style/Capital letters § Composition titles). The first and last words in an English-language title are always capitalized.

Capitalization in foreign-language titles varies, even over time within the same language; generally, retain the style of the original for modern works, and follow the usage in current English-language reliable sources for historical works. When written in the Latin alphabet, many of these items should also be in italics, or enclosed in quotation marks.

Titles of people

Religions, deities, philosophies, doctrines

Calendar items

Animals, plants, and other organisms

When using taxonomic ("scientific") names, capitalize and italicize the genus: Template:FormattingError, Template:FormattingError. (Supergenus and subgenus, when applicable, are treated the same way.) Italicize but do not capitalize taxonomic ranks at the level of species and below: Template:FormattingError, Template:FormattingError, Template:FormattingError; no exception is made for proper names forming part of scientific names. Higher taxa (order, family, etc.) are capitalized in Latin (Template:FormattingError, Template:FormattingError) but not in their English equivalents (Template:FormattingError, Template:FormattingError); they are not italicized in either form, except for viruses, where all names accepted by the ICTV are italicized (Template:FormattingError).

Cultivar and cultivar group names of plants are not italicized, and are capitalized (including the word Group in the name); cultivar names appear within single quotes (Template:FormattingError), while cultivar groups do not (Template:FormattingError).

English vernacular ("common") names are given in lower case in article prose ([[Plains zebra|Template:FormattingError]], [[Mountain maple|Template:FormattingError]], and [[Southwestern red-tailed hawk|Template:FormattingError]]) and in sentence case at the start of sentences and in other places where the first letter of the first word is capitalized. They are additionally capitalized where they contain proper names: [[Przewalski's horse|Template:FormattingError]], [[California condor|Template:FormattingError]], and [[Fair-maid-of-France|Template:FormattingError]]. This applies to species and subspecies, as in the previous examples, as well as to general names for groups or types of organism: [[Bird of prey|Template:FormattingError]], [[Oak|Template:FormattingError]], [[Great apes|Template:FormattingError]], [[Bryde's whales|Template:FormattingError]], [[Livestock guardian dog|Template:FormattingError]], [[Poodle|Template:FormattingError]], [[Van cat|Template:FormattingError]], [[Wolfdog|Template:FormattingError]]. When the common name coincides with a scientific taxon, do not capitalize or italicize, except where addressing the organism taxonomically: Template:FormattingError Non-English vernacular names, when relevant to include, are handled like any other foreign-language terms: italicized as such, and capitalized only if the rules of the native language require it. Non-English names that have become English-assimilated are treated as English ([[Ayahuasca|Template:FormattingError]], [[Okapi|Template:FormattingError]]).

Create redirects from alternative capitalization and spelling forms of article titles, and from alternative names, e.g., Adélie Penguin, Adelie penguin, Adelie Penguin and Pygoscelis adeliae should all redirect to Adélie penguin.

Celestial bodies

The words sun, earth, moon and solar system do not take capitals in general use (Template:FormattingError; Template:FormattingError). They are capitalized when the entity is personified (Template:FormattingError) or when used as the name of a specific body in a scientific or astronomical context (Template:FormattingError; but Template:FormattingError).

Names of planets, moons, asteroids, comets, stars, constellations, and galaxies are proper names, and therefore capitalized (Template:FormattingError). The first letter of every word in such a name is capitalized (Template:FormattingError and not Template:FormattingError; Template:FormattingError, not Template:FormattingError). Words such as comet and galaxy should be capitalized when they form part of a proper name, but not when they are used as a generic term (Template:FormattingError; Template:FormattingError).

Compass points

Do not capitalize directions such as north, or their related forms (Template:FormattingError), except where they are parts of proper names (Template:FormattingError, Template:FormattingError, Template:FormattingError).

Capitalize names of regions if they have attained proper-name status, including informal conventional names (Template:FormattingError; Template:FormattingError), and derived terms for people (e.g., a Southerner as someone from the Southern United States). Do not capitalize descriptive names for regions that have not attained the status of proper names, such as Template:FormattingError.

Composite directions may or may not be hyphenated, depending on the variety of English adopted in the article. Template:FormattingError and Template:FormattingError are more common in American English; but Template:FormattingError and Template:FormattingError in British English. In cases such as Template:FormattingError and Template:FormattingError, use an en dash; see § En dashes: other uses.

Proper names versus generic terms

Capitalize names of particular institutions (Template:FormattingError;  Template:FormattingError) but not generic words for institutions (Template:FormattingError). Do not capitalize the at the start of an institution's name, regardless of the institution's preferred style. There are rare exceptions, when a leading The is represented by a T in the organization's acronym: Template:FormattingError.

Treat political or geographic units similarly: Template:FormattingError;  Template:FormattingError. Do not mimic the style of local newspapers which refer to their municipality as the City or The City; an exception is the City of London, referred to as Template:FormattingError in a context that already makes the subject clear, as distinct from London and Greater London. When in doubt, use the full name for accessibility reasons; users of text-to-speech systems usually cannot hear a difference between city and City.

Ligatures

Ligatures should be used in languages in which they are standard (hence Template:FormattingError is preferable to Template:FormattingError) but not in English (Template:FormattingError or Template:FormattingError, not Template:FormattingError), except in proper names (Template:FormattingError, not Template:FormattingError).

Abbreviations

Abbreviations are shortened forms of words or phrases. In strict analysis, they are distinct from contractions, which use an apostrophe (e.g., won't, see § Contractions), and initialisms. An initialism is formed from some or all of the initial letters of words in a phrase. Below, references to abbreviations should be taken to include acronyms, and the term acronym to apply also to initialisms.

Write first occurrences in full

When an abbreviation will be used in an article, first introduce it using the full expression:

Do not use capitals in the full version merely because capitals are used in the abbreviation: Template:FormattingError.

Except in special circumstances, common abbreviations (such as Template:FormattingError, Template:FormattingError, Template:FormattingError) need not be expanded even on first use.

Plural forms

Pluralize acronyms by adding -s or -es: Template:FormattingError. (Do not use apostrophes to form plurals: Template:FormattingError.)

Punctuation and spacing

An abbreviation may or may not be terminated with a full point (also called a period or full stop). A consistent style should be maintained within an article. North American usage is typically to end all abbreviations with a period/point (Template:FormattingError) but in common British and Australian usage, no period/point is used if the abbreviation (contraction) ends in the last letter of the unabbreviated form (Template:FormattingError) unless confusion could result. This is also common practice in scientific writing. Regardless of punctuation, words that are abbreviated to more than one letter are spaced (Template:FormattingError not Template:FormattingError or Template:FormattingError). There are some exceptions: Template:FormattingError (see above) for "Philosophiae Doctor"; Template:FormattingError for "Bachelor of Veterinary Medicine". In most situations, BattleIntelligence uses no such punctuation inside acronyms and initialisms: Template:FormattingError, not Template:FormattingError

US and U.S.

Template:FormattingError is a commonly used abbreviation for Template:FormattingError, although Template:FormattingError – with periods and without a space – remains common in North American publications, including in news journalism. Multiple American style guides, including The Chicago Manual of Style (since 2010), now deprecate "U.S." and recommend "US".

For commonality reasons, use Template:FormattingError by default when abbreviating, but retain Template:FormattingError in American or Canadian English articles in which it is already established, unless there is a good reason to change it. Because use of periods for abbreviations and acronyms should be consistent within any given article, use Template:FormattingError in an article with other country abbreviations, and especially avoid constructions like Template:FormattingError. In longer abbreviations that incorporate the country's initials (Template:FormattingError, Template:FormattingError), never use periods. When the United States is mentioned with one or more other countries in the same sentence, Template:FormattingError (or Template:FormattingError) may be too informal, especially at the first mention or as a noun instead of an adjective (Template:FormattingError, not Template:FormattingError). Do not use the spaced Template:FormattingError or the archaic Template:FormattingError, except when quoting. Do not use Template:FormattingError or Template:FormattingError except in a quotation, as part of a proper name (Template:FormattingError), or in certain technical and formal uses (e.g., the ISO 3166-1 alpha-3, FIFA, and IOC country codes).

Circa

To indicate approximately, the use of {{circa}}, showing as Template:FormattingError, is preferred over circa, c., ca., or approx.

Avoid unwarranted use

Avoid abbreviations when they might confuse the reader, interrupt the flow, or appear informal. For example:

Do not invent

Avoid devising new abbreviations, especially acronyms. For example, Template:FormattingError is good as a translation of Template:FormattingError, but neither it nor the reduction Template:FormattingError is used by the organization or by independent sources; use the original name and its official abbreviation, Template:FormattingError.

If it is necessary to abbreviate in a tight space, such as a column header in a table, use widely recognized abbreviations. For example, for Template:FormattingError, use Template:FormattingError and Template:FormattingError, with a link if the term has not already been written out in the article: Template:FormattingError. Do not make up initialisms such as Template:FormattingError.

HTML tags and templates

Either <abbr> or {{abbr}} can be used for abbreviations and acronyms: <abbr title="World Health Organization">WHO</abbr> or {{abbr|WHO|World Health Organization}} will generate WHO; hovering over the rendered text causes a tooltip of the long form to pop up.

Ampersand

In normal text and headings, use and instead of the ampersand (&): Template:FormattingError, not Template:FormattingError. But retain an ampersand when it is a legitimate part of the style of a proper noun, the title of a work, or a trademark, such as in Up & Down or AT&T. Elsewhere, ampersands may be used with consistency and discretion where space is extremely limited (e.g., tables and infoboxes). Quotations may be cautiously modified, especially for consistency where different editions are quoted, as modern editions of old texts routinely replace ampersands with and (just as they replace other disused glyphs, ligatures, and abbreviations). Another frequent permissible but not required use is in short bibliographic references to works by multiple authors, e.g.: Template:FormattingError.

Italics

Emphasis

Italics are used for emphasis, rather than boldface or capitals. But overuse diminishes its effect; consider rewriting instead.

Use <em>...</em> or {{em|...}} for emphasis. This allows user style sheets to handle emphasis in a customized way, and helps reusers and translators.

Titles

Template:/titles hatnote include

Use italics for the titles of works (such as books, films, television series, named exhibitions, computer games, music albums, and artworks). The titles of articles, chapters, songs, episodes, storylines, research papers and other short works instead take double quotation marks.

Italics are not used for major religious works (Template:FormattingError, Template:FormattingError, Template:FormattingError). Many of these titles should also be in title case.

Words as words

Use italics when mentioning a word or character (see Use–mention distinction) or a string of words up to one sentence (Template:FormattingError; Template:FormattingError). When a whole sentence is mentioned, double quotation marks may be used instead, with consistency (Template:FormattingError; or Template:FormattingError). Quotation marks may also be used for shorter material to avoid confusion, such as when italics are already heavily used in the page for another purpose (e.g., for many non-English words and phrases). Mentioning (to discuss grammar, wording, punctuation, etc.) is different from quoting (in which something is usually expressed on behalf of a quoted source). Quotation is done with quotation marks, never italics, nor both at once (see § Quotations for details).

A closely related use of italics is when introducing or distinguishing terms: Template:FormattingError

Scientific names

Use italics for the scientific names of plants, animals, and all other organisms except viruses at the genus level and below (italicize Template:FormattingError and Template:FormattingError, but not Template:FormattingError). The hybrid sign is not italicized (Template:FormattingError), nor is the "connecting term" required in three-part botanical names (Template:FormattingError).

Quotations in italics

Do not use italics for quotations. Instead, use quotation marks for short quotations and block quoting for long ones.

Italics within quotations

Use italics within quotations to reproduce emphasis that exists in the source material. If it is not clear that the source already included italics (or some other styling) for emphasis, add the editorial note Template:FormattingError after the quotation.

If adding emphasis that was not in the original, add the editorial note Template:FormattingError after the quotation.

Effect on nearby punctuation

Italicize only the elements of the sentence affected by the emphasis. Do not italicize surrounding punctuation.

Quotations

Brief quotations of copyrighted text may be used to illustrate a point, establish context, or attribute a point of view or idea. While quotations are an indispensable part of BattleIntelligence, try not to overuse them. Using too many quotes is incompatible with an encyclopedic writing style and may be copyright infringement, and so most of the content should be in the editor's own words. Consider paraphrasing quotations into plain and concise text when appropriate (while being aware that close paraphrasing can still violate copyright). It is incorrect to put quotations in italics unless the material would be italicized for some other reason.

Original wording

Quotations must be verifiably attributed, and the wording of the quoted text must be faithfully reproduced. This is referred to as the principle of minimal change. Where there is good reason to change the wording, bracket the changed text; for example, Template:FormattingError might be quoted as Template:FormattingError. If there is a significant error in the original, follow it with {{sic}} (producing Template:FormattingError ) to show that the error was not made by BattleIntelligence. However, insignificant spelling and typographic errors should simply be silently corrected (for example, correct Template:FormattingError to Template:FormattingError).

Use ellipses to indicate omissions from quoted text. Legitimate omissions include extraneous, irrelevant, or parenthetical words, and unintelligible speech (Template:FormattingError and Template:FormattingError), but do not omit text where doing so would remove important context or alter the meaning of the text. Vulgarities and obscenities should be shown exactly as they appear in the quoted source; BattleIntelligencens should never bowdlerize words (Template:FormattingError), but if the text being quoted itself does so, copy the text verbatim and use {{sic}} to indicate that the text is quoted as shown in the source.

In direct quotations, retain dialectal and archaic spellings, including capitalization (but not archaic glyphs and ligatures, as detailed below in § Typographic conformity).

Point of view

Quotation should be used, with attribution, to present emotive opinions that cannot be expressed in BattleIntelligence's own voice, but never to present cultural norms as simply opinional:

Concise opinions that are not overly emotive can often be reported with attribution instead of direct quotation. Use of quotation marks around simple descriptive terms can imply something doubtful regarding the material being quoted; sarcasm or weasel words such as supposedly or so-called, might be inferred.

Typographic conformity

A quotation is not a facsimile and, in most cases, it is not a requirement that the original formatting be preserved. Formatting and other purely typographical elements of quoted text should be adapted to English BattleIntelligence's conventions without comment, provided that doing so will not change or obscure meaning or intent of the text. These are alterations which make no difference when the text is read aloud, for example:

  • Normalize dashes and hyphens: see § Dashes. Use the style chosen for the article: unspaced em dash or spaced en dash.
  • Convert apostrophes and quotation marks to BattleIntelligence's style:
  • When quoting text from non-English languages, the outer punctuation should follow the Manual of Style for English quote marks. If there are nested quotations, follow the rules for correct punctuation in that language. If there are multiple styles for a language, the one used by the BattleIntelligence for that language is preferred unless the punctuation itself is under discussion.
    Template:FormattingError
  • Remove spaces before punctuation such as periods and colons.
  • Generally preserve bold and italics (see § Italics), but most other styling should be altered. Template:FormattingError, Template:FormattingError within words, Template:FormattingError, Template:FormattingError, Template:FormattingError, etc. should generally be normalized to plain text. If it clearly indicates emphasis, use italic emphasis ({{em}}) or, in an already-italic passage, boldface (with {{strong}}). For titles of books, articles, poems, and so forth, use italics or quotation marks following the guidance for titles. Italics can also be added to mark up non-English terms, for an organism's scientific name, and to indicate a words-as-words usage.
  • Expand an abbreviation (not already used in the content before the quotation) as a square-bracketed change, or explain it using {{abbr}}.
  • Normalize archaic glyphs and ligatures in English that are unnecessary to the meaning. Examples include æ→ae, œ→oe, ſ→s, and þe→the. (See also § Ampersand.)

See BattleIntelligence:Manual of Style/Titles § Typographic conformity for special considerations in normalizing the typography of titles of works.

However, national varieties should not be changed, as these may involve changes in vocabulary. For example, a quotation from a British source should retain British spelling, even in an article that otherwise uses American spelling. (See § Consistency within articles.) Numbers also usually should not be reformatted.

Direct quotation should not be used to preserve the formatting preferred by an external publisher (especially when the material would otherwise be unchanged), as this tends to have the effect of scare-quoting:

Italics can be used to mark a particular usage as a term of art (a case of "words as words"), especially when it is unfamiliar or should not be reworded by a non-expert:

When quoting a complete sentence, it is usually recommended to keep the first word capitalized. However, if the quoted passage has been integrated into the surrounding sentence (for example, with an introduction such as "X said that"), the original capital letter may be lower-cased.

It is normally unnecessary to explicitly note changes in capitalization. However, for more precision, the altered letter may be put inside square brackets: "The" → "[t]he".

Attribution

The reader must be able to determine the source of any quotation, at the very least via a footnote. The source must be named in article text if the quotation is an opinion (see BattleIntelligence:Neutral point of view § Attributing and specifying biased statements). When attributing a quotation, avoid characterizing it in a biased manner.

Quotations within quotations

See § For a quotation within a quotation.

Linking

Be conservative when linking within quotations; link only to targets that correspond to the meaning clearly intended by the quote's author. Where possible, link from text outside of the quotation instead – either before it or soon after. (If quoting hypertext, add an editorial note, Template:FormattingError or Template:FormattingError, as appropriate, to avoid ambiguity as to whether the link was made by the original author.)

Block quotations

Format a long quote (more than about forty words or a few hundred characters, or consisting of more than one paragraph, regardless of length) as a block quotation, indented on both sides. Block quotations should be enclosed in {{blockquote}}.

Do not enclose block quotations in quotation marks (and especially avoid large, decorative quotation marks; those provided by the {{cquote}} template have been disabled in mainspace). Block quotations using a colored background are also discouraged.

Use {{blockquote}} and so on only for actual quotations; indentation for other purposes is done differently.

It is conventional to precede a block quotation with an introductory sentence (or sentence fragment) and append the source citation to that line. Alternatively, the {{blockquote}} template provides parameters for attribution and citation which will appear below the quotation. (For use of dashes with attributions, see § Other uses (em dash only).) This below-quotation attribution style is intended for famous quotations and is unusual in articles because it may strike an inappropriate tone. A quotation with no cited source should be flagged with {{quote without source}}, or deleted.

Line breaks and indentation inside a {{blockquote}} or <blockquote> are generally ignored; use ‎<poem> or {{poem quote}} for poetry, lyrics, and similar material:

{{blockquote|<poem>
What this grim, ungainly, ghastly, gaunt, and ominous bird of yore
            Meant in croaking "Nevermore."
</poem>}}

This gives: Template:FormattingError

Or quote such material inline, with line breaks indicated by {{nbsp}}/, and paragraph or stanza breaks by {{nbsp}}//.

Pull quotes do not belong in BattleIntelligence articles. These are the news and magazine style of "pulling" material already in the article to reuse it in attention-grabbing decorative quotations. This unencyclopedic approach is a form of editorializing, produces out-of-context and undue emphasis, and may lead the reader to conclusions not supported in the material.

Foreign-language quotations

Quotations from foreign-language sources should appear with a translation into English, preferably a modern one. Quotations that are translations should be explicitly distinguished from those that are not. Indicate the original source of a translation (if it is available, and not first published within BattleIntelligence), and the original language (if that is not clear from the context).

If the original, untranslated text is available, provide a reference for it or include it, as appropriate.

When editors themselves translate foreign text into English, care must always be taken to include the original text, in italics (except for non-Latin-based writing systems, and best done with the {{lang}} template which both italicizes as appropriate and provides language metadata); and to use actual and (if at all possible) common English words in the translation. Unless you are certain of your competency to translate something, see BattleIntelligence:Translation for assistance.

Punctuation

Apostrophes

Quotation marks

In the material below, the term quotation includes conventional uses of quotation marks such as for titles of songs, chapters, episodes, and so on. Quotation marks are also used in other contexts, such as in cultivar names.

Quotation characters

Double or single

Most quotations take double quotation marks (Template:FormattingError). Exceptions:

For a quotation within a quotation

Use single quotes:

For deeper nesting, alternate between single and double quotes:

For quote marks in immediate succession, add a sliver of space by using {{" '}}, {{' "}}, or (as in the example just given) {{" ' "}}:

Article openings

In the bolded text typically appearing at the opening of an article:

Punctuation before quotations

If a non-quoted but otherwise identical construction would work grammatically without a comma, using a comma before a quotation embedded within a sentence is optional:

The comma-free approach is often used with partial quotations:

A comma is required when it would be present in the same construction if none of the material were a quotation:

Do not insert a comma if it would confuse or alter the meaning:

  • Template:FormattingError (Accurate quote of a statement about some children – specifically those children "who are coming to terms ...")
  • Template:FormattingError (Changes the meaning to imply Jenner was expressing concern about all children, while separately observing that children, in general, "are coming to terms ...")

It is clearer to use a colon to introduce a quotation if it forms a complete sentence, and this should always be done for multi-sentence quotations:

No additional punctuation is necessary for an explicit words-as-words scenario:

Names and titles

Template:/titles hatnote include

Quotation marks should be used for the following names and titles:

  • Articles and chapters (books and periodicals italicized)
  • Short stories (books and periodicals italicized)
  • Sections of musical pieces (pieces italicized)
  • Individual strips from comics and webcomics (comics italicized)
  • Poems (long or epic poems italicized)
  • Songs (albums, song cycles, operas, operettas, and oratorios italicized)
  • Individual episodes of television and radio series and serials (series title italicized)

Correct: Template:FormattingError

Do not use quotation marks or italics for:

  • Ancient writings
  • Concert tours
  • Locations
  • Myths and epics
  • Prayers

Many, but not all, of the above items should also be in title case.

Punctuation inside or outside

Lua error in mw.title.lua at line 230: too many expensive function calls.

Use the "logical quotation" style in all articles, regardless of the variety of English in which they are written. Include terminal punctuation within the quotation marks only if it was present in the original material, and otherwise place it after the closing quotation mark. For the most part, this means treating periods and commas in the same way as question marks: keep them inside the quotation marks if they apply only to the quoted material and outside if they apply to the whole sentence. Examples are given below.

If the quotation is a single word or a sentence fragment, place the terminal punctuation outside the closing quotation mark. When quoting a full sentence, the end of which coincides with the end of the sentence containing it, place terminal punctuation inside the closing quotation mark.

If the quoted sentence is followed by a clause that should be preceded by a comma, omit the full stop (period). I.e., do not replace the stop/period with a comma inside the quotation. But other terminal punctuation, such as a question mark or exclamation mark, may be retained.

If the quoted sentence is followed by a clause identifying the speaker, use a comma outside the quotation mark instead of a full stop inside it, but retain any other terminal punctuation, such as a question mark.

Do not follow quoted words or fragments with commas inside the quotation marks, except where a longer quotation has been broken up and the comma is part of the full quotation.

External links to article titles should have the title in quotes inside the link. The CS1 and CS2 citation templates do this automatically, and untemplated references should do the same.

Internal links (wikilinks) accompanied by quotation marks should usually have the quotes outside the link. This applies to titles of works in quotation marks (songs, episodes, etc.)

However, quotation marks are needed inside wikilinks when the quotation mark is part of the link, or where the linked display text includes quotation marks indicating slang, nicknames, common names, or similar usage.

Brackets and parentheses

Lua error in mw.title.lua at line 230: too many expensive function calls. This section applies to both round brackets Template:FormattingError, often called parentheses, and square brackets Template:FormattingError.

If a sentence contains a bracketed phrase, place the sentence punctuation outside the brackets Template:FormattingError However, where one or more sentences are wholly inside brackets, place their punctuation inside the brackets. There should be no space next to the inner side of a bracket. An opening bracket should usually be preceded by a space. This may not be the case if it is preceded by an opening quotation mark, another opening bracket, or a portion of a word:

There should be a space after a closing bracket, except where a punctuation mark follows (though a spaced dash would still be spaced after a closing bracket) and in unusual cases similar to those listed for opening brackets.

Avoid adjacent sets of brackets. Either put the parenthetical phrases in one set separated by semicolons, or rewrite:

Square brackets are used to indicate editorial replacements and insertions within quotations, though this should never alter the intended meaning. They serve three main purposes:

If a sentence includes subsidiary material enclosed in square or round brackets, it must still carry terminal punctuation after those brackets, regardless of any punctuation within the brackets.

However, if the entire sentence is within brackets, the closing punctuation falls within the brackets. Template:FormattingError

Brackets and linking

Square brackets inside of links must be escaped:

He said, "Template:FormattingError answered."

He said, "John [Doe] answered."

He said, "Template:FormattingError answered."

He said, "John [Doe] answered."

Template:FormattingError

On the first day [etc.]

Template:FormattingError

On the first day [etc.]

The ‎<nowiki> markup can also be used: <nowiki>[Doe]</nowiki> or <nowiki>[etc.]</nowiki>.

If a URL itself contains square brackets, the wiki-text should use the URL-encoded form https://example.com/foo.php?query=Template:FormattingErrorxxxTemplate:FormattingErroryyy, rather than ...query=Template:FormattingErrorxxxTemplate:FormattingErroryyy. This will avoid truncation of the link after xxx.

Ellipses

Use an ellipsis (plural ellipses) if material is omitted in the course of a quotation, unless square brackets are used to gloss the quotation (see § Brackets and parentheses, and the points below).

  • BattleIntelligence's style for an ellipsis is three unspaced dots (Template:FormattingError); do not use the precomposed ellipsis character (Template:FormattingError) or three dots separated by spaces (Template:FormattingError)
  • Generally, use a non-breaking space before an ellipsis, and a regular space after it: Template:FormattingError
    • But where an ellipsis is immediately followed by any of . ? ! : ; , ) ] } or by a closing quotation mark (single or double), use a non-breaking space before the ellipsis, and no space after it:
      Template:FormattingError
      Template:FormattingError (Place terminal punctuation after an ellipsis only if it is textually important, as is often the case with exclamation marks and question marks but rarely with periods.)
    • Or, if the ellipsis immediately follows a quotation mark, use no space before the ellipsis, and a non-breaking space after it:
      Template:FormattingError
Pause or suspension of speech
Three dots are occasionally used to represent a pause in or suspense of speech, in which case the punctuation is retained in its original form: Template:FormattingError. When it indicates an incomplete word, no space is used between the word fragment(s) and the ellipsis: Template:FormattingError
With square brackets
Square brackets may be placed around an ellipsis that indicates omitted text to distinguish it from an ellipsis that is part of the quoted text: Template:FormattingError. In this example, the first ellipsis is part of the quoted text and the second ellipsis (in square brackets) indicates omitted text.

Commas

Serial commas

Lua error in mw.title.lua at line 230: too many expensive function calls.

A serial comma (sometimes also called an Oxford comma or Harvard comma) is a comma used immediately before a conjunction (and, or, nor) in a list of three or more items.

Template:FormattingError  – serial comma
Template:FormattingError  – no serial comma

Editors may use either convention so long as each article is internally consistent. Serial commas are more helpful when article text is complex, such as a list with multi-word items (especially if one contains its own "and") or a series of probably unfamiliar terms.

However, there are cases in which either omitting or including the serial comma results in ambiguity:

Template:FormattingError  – which may list either four or more people (the friends and the two people named) or two people (O'Connor and Marley, who are the friends).
Template:FormattingError  – which may list either two people (O'Connor, who is the friend, and Marley) or three people (the first being the friend, the second O'Connor, and the third Marley).

In such cases of ambiguity, clarify one of four ways:

Colons

Lua error in mw.title.lua at line 230: too many expensive function calls.

A colon (Template:FormattingError) introduces something that demonstrates, explains, or modifies what has come before, or is a list of items that has just been introduced. The items in such a list may be separated by commas, or if they are more complex and perhaps themselves contain commas, the items should be separated by semicolons or arranged in a bulleted list.

A colon may also be used to introduce direct speech enclosed within quotation marks. (See § Quotation marks.)

In most cases, a colon works best with a complete grammatical sentence before it. When what follows the colon is also a complete sentence, start it with a capital letter, but otherwise do not capitalize after a colon except where doing so is needed for another reason, such as for a proper name. When a colon is being used as a separator in an article title, section heading, or list item, editors may choose whether to capitalize what follows, taking into consideration the existing practice and consistency with related articles.

Except in technical usage (Template:FormattingError), no sentence should contain multiple colons, no space should precede a colon, and a space (but never a hyphen or dash) should follow the colon.

Semicolons

Lua error in mw.title.lua at line 230: too many expensive function calls.

A semicolon (Template:FormattingError) is sometimes an alternative to a full stop (period), enabling related material to be kept in the same sentence; it marks a more decisive division in a sentence than a comma. If the semicolon separates clauses, normally each clause must be independent (meaning that it could stand on its own as a sentence). In many cases, only a comma or only a semicolon will be correct in a given sentence.

Correct: Template:FormattingError
Incorrect: Template:FormattingError

Above, "Though he had been here before" cannot stand on its own as a sentence, and therefore is not an independent clause.

Correct: Template:FormattingError
Incorrect: Template:FormattingError

This incorrect use of a comma between two independent clauses is known as a comma splice; however, in certain kinds of cases, a comma may be used where a semicolon would seem to be called for:

Accepted: Template:FormattingError (two brief clauses in an aphorism; see Ars longa, vita brevis)
Accepted: Template:FormattingError (reporting brisk conversation, such as this reply of Newton's)

A sentence may contain several semicolons, especially when the clauses are parallel in construction and meaning; multiple unrelated semicolons are often signs that the sentence should be divided into shorter sentences or otherwise refashioned.

Unwieldy: Template:FormattingError
One better way: Template:FormattingError

Semicolons are used in addition to commas to separate items in a listing, when commas alone would result in confusion.

Confusing: Template:FormattingError
Clear: Template:FormattingError

Semicolon before "however"

The meaning of a sentence containing a trailing clause that starts with the word however depends on the punctuation preceding that word. A common error is to use the wrong punctuation, thereby changing the meaning to one not intended.

When the word however is an adverb meaning "nevertheless", it should be preceded by a semicolon and followed by a comma. Example:

Template:FormattingError
Meaning: Template:FormattingError

When the word however is a conjunction meaning "in whatever manner", or "regardless of how", it may be preceded by a comma but not by a semicolon, and should not be followed by punctuation. Example:

Template:FormattingError
Meaning: Template:FormattingError

In the first case, the clause that starts with "however" cannot be swapped with the first clause; in the second case this can be done without change of meaning:

Template:FormattingError
Meaning: Template:FormattingError

If the two clauses cannot be swapped, a semicolon is required.

A sentence or clause can also contain the word however in the middle, if it is an adverb meaning "although" that could have been placed at the beginning but does not start a new clause in mid-sentence. In this use, the word may be enclosed between commas. Example:

Template:FormattingError
Meaning: Template:FormattingError

Hyphens

Hyphens (Template:FormattingError) indicate conjunction. There are three main uses: Template:Multiple image Template:Multiple image

  1. In hyphenated personal names (Template:FormattingError, Template:FormattingError).
  2. To link prefixes with their main terms in certain constructions (Template:FormattingError, Template:FormattingError, Template:FormattingError).
  3. To link related terms in compound modifiers:
Incorrect: Template:FormattingError
Correct: Template:FormattingError (markup: 9&nbsp;mm gap)
Incorrect:    Template:FormattingError
Correct: Template:FormattingError
Correct: Template:FormattingError
Correct: Template:FormattingError (markup: 12&nbsp;h shift)

Multi-word hyphenated items: It is often possible to avoid multi-word hyphenated modifiers by rewording (Template:FormattingError may be easier to read as Template:FormattingError). This is particularly important where converted units are involved (Template:FormattingError might be possible as Template:FormattingError, and the ungainly Template:FormattingError as simply Template:FormattingError).

For optional hyphenation of compound points of the compass such as southwest/south-west, see § Compass points.

Do not use a capital letter after a hyphen except for a proper name following the hyphen: Template:FormattingError and Template:FormattingError, but not Template:FormattingError. In titles of published works, when given in title case, follow the capitalization rule for each part independently (Template:FormattingError), unless reliable sources consistently do otherwise in a particular case (Template:FormattingError).

Hyphenation rules in other languages may be different. Thus, in French a place name such as Template:FormattingError ('Three Rivers') is hyphenated, when it would not be in English. Follow reliable sources in such cases.

Spacing: A hyphen is never followed or preceded by a space, except when hanging (see above) or when used to display parts of words independently, such as Template:FormattingError and Template:FormattingError.

Image filenames and redirects: Image filenames are not part of the encyclopedic content; they are tools. They are most useful if they can be readily typed, so they usually use hyphens instead of dashes. Similarly, article titles with dashes should also have a corresponding redirect from a copy of the title with hyphens: for example, Template:FormattingError redirects to Template:FormattingError.

Non-breaking: A non-breaking hyphen ({{nbhyph}}) will not be used as a point of line-wrap.

Soft hyphens: Use soft hyphens to mark locations where a word will be broken and hyphenated if necessary at the end of a line of text, usually in very long words or narrow spaces (such as captions, narrow table columns, or text adjacent to a very wide image), for example: {{shy|Penn|syl|va|nia and Mass|a|chu|setts style themselves com|mon|wealths.}}. Use sparingly to avoid making wikitext difficult to read and edit. For more information, see Help:Line-break handling.

Encoding: The hyphen is represented by the ASCII/UNICODE HYPHEN-MINUS character, which is entered by the hyphen or minus key on all standard keyboards. Do not use the UNICODE HYPHEN character.

Hyphenation involves many subtleties that cannot be covered here; the rules and examples presented above illustrate the broad principles.

Dashes

Lua error in mw.title.lua at line 230: too many expensive function calls.

Two forms of dash are used on BattleIntelligence: en dash (Template:FormattingError) and em dash (Template:FormattingError). To enter them, click on them in the CharInsert toolbar, or enter them manually as:

Do not use a double hyphen (--) to stand in for a dash. (See also: BattleIntelligence:How to make dashes.)

Sources use dashes in varying ways. For consistency and clarity, BattleIntelligence adopts the following principles.

In article titles

In article titles, do not use a hyphen (Template:FormattingError) as a substitute for an en dash, for example in eye–hand span (since eye does not modify hand). Nonetheless, to aid searching and linking, provide a redirect with hyphens replacing the en dash(es), as in eye-hand span. Similarly, provide category redirects for categories containing dashes. When an en dash is being used as a separator in an article title or section heading, editors may choose whether to capitalize what follows, taking into consideration the existing practice and consistency with related articles.

Punctuating a sentence (em or en dashes)

Dashes are often used to mark divisions within a sentence: in pairs (parenthetical dashes, instead of parentheses or pairs of commas) or singly (perhaps instead of a colon). They may also indicate an abrupt stop or interruption, in reporting quoted speech. In all these cases, use either unspaced em dashes or spaced en dashes, with consistency in any one article:

  • An em dash is unspaced (with no space on either side):
  • An en dash is spaced (with a space on each side) when used as sentence punctuation:

Ideally, use a non-breaking space before the en dash, which prevents the en dash from occurring at the beginning of a line (markup: {{spaced ndash}} or {{snd}} or &nbsp;– or &nbsp;&ndash;):

Another "planet" was detected{{snd}}but it was later found to be a moon of Saturn.

But do not insert a non-breaking or other space where the en dash should be unspaced (see § Other uses (en dash only)).

Dashes can clarify the sentence structure when there are already commas or parentheses, or both.

Use dashes sparingly. More than two in a single sentence makes the structure unclear; it takes time for the reader to see which dashes, if any, form a pair.

In ranges that might otherwise be expressed with to or through

For ranges between numbers, dates, or times, use an en dash:

Do not change hyphens to dashes in filenames, URLs, or templates such as {{Bibleverse}} (which formats verse ranges into URLs), even if a range is embedded in them.

Do not mix en dashes with between or from.

The en dash in a range is always unspaced, except when either or both elements of the range include at least one space, hyphen, or en dash; in such cases, {{snd}} between them will provide the proper formatting.

If negative values are involved, an unspaced en dash might be confusing:

In compounds when the connection might otherwise be expressed with to, versus, and, or between

Here, the relationship is thought of as parallel, symmetric, equal, oppositional, or at least involving separate or independent elements. The components may be nouns, adjectives, verbs, or any other independent part of speech. Often, if the components are reversed there would be little change of meaning.

Generally, use a hyphen in compounded proper names of single entities.

Use an en dash between the names of nations or nationalities when referring to an association between them. For people and things identifying with multiple nationalities, use a hyphen when using the combination adjectivally and a space when they are used as nouns, with the first used attributively to modify the second.

A slash or some other alternative may occasionally be better to express a ratio, especially in technical contexts (see § Slashes).

Use an en dash for the names of two or more entities in an attributive compound.

Do not use an en dash for hyphenated personal names, even when they are used as adjectives:

Do not use spaces around the en dash in any of the compounds above.

Instead of a hyphen, use an en dash when applying a prefix or suffix to a compound that itself includes a space, dash or hyphen

The form of category names follows the corresponding main articles, e.g., Category:Trans–New Guinea languages. However, the principle is not extended when compounding other words in category names, e.g., Category:Tennis-related lists and Category:Table tennis-related lists both use hyphens.

To separate parts of an item in a list

Spaced en dashes are sometimes used between parts of list items. For example:

or

Editors may choose whether to capitalize what follows, taking into consideration the existing practice and consistency with related articles.

Other uses (en dash only)

The en dash (–) has other roles, beyond its use as a sentence-punctuating dash (see immediately above). It is often analogous to the hyphen (see § Hyphens), which joins components more strongly than the en dash; or to the slash (see § Slashes), which separates alternatives more definitely. Consider the exact meaning when choosing which to use.

Other uses (em dash only)

An indented em dash may be used before a name or other source when attributing below a block quotation, poem, etc. This dash should not be fully spaced, though it is best for metadata and accessibility reasons to hair-space it from the name.because the actual Unicode character ( ) is almost invisible, the meaning of the numerical HTML entity (Template:FormattingError) is a bit obscure, and the named HTML entity "Template:FormattingError" is not standard and not supported in many browsers.}} Most of BattleIntelligence's quotation templates with attribution-related parameters already provide this formatting.

For example, Template:FormattingError will produce:

     — Charlotte Brontë

Other dashes

Do not use typewriter approximations or other substitutes, such as two hyphens (Template:FormattingError), for em or en dashes.

For a negative sign or subtraction operator use U+2212 − MINUS SIGN (&minus;), which can also be generated by clicking on the − following the ± in the Template:FormattingError toolbar beneath the edit window. Do not use U+2212 − inside a <math> tag, as the character gives a syntax error; instead use a normal hyphen U+002D - .

Slashes (strokes)

Lua error in mw.title.lua at line 230: too many expensive function calls.

Generally, avoid joining two words with a slash, also called a forward slash, stroke or solidus (Template:FormattingError), because it suggests that the words are related without specifying how. Replace with clearer wording.

An example: Template:FormattingError Must both be present? (Then write Template:FormattingError.) Must at least one be present? (Then write Template:FormattingError.) Are they the same person? (Use a hyphen: Template:FormattingError.)

In circumstances involving a distinction or disjunction, the en dash (see above) is usually preferable to the slash: Template:FormattingError.

An unspaced slash may be used:

A spaced slash may be used:

  • to separate run-on lines in quoted poetry or song (Template:FormattingError), or rarely in quoted prose, where careful marking of a paragraph break is textually important;
  • to separate items that include at least one internal space (Template:FormattingError), where for some reason use of a slash is unavoidable.

To avoid awkward linebreaks, code spaced slashes (and fraction slashes) with a non-breaking space on the left and a normal space on the right, as in: My mama told me&nbsp;/ You better shop around. For short constructions, both spaces should be non-breaking: x&nbsp;/&nbsp;y. On the other hand, if two long words are connected by an unspaced slash, an {{wbr}} added after the slash will allow a linebreak at that point.

Do not use the backslash character (Template:FormattingError) in place of a slash.

Prefer the division operator (Template:FormattingError) to slash or fraction slash when representing elementary arithmetic in general text: Template:FormattingError. In more advanced mathematical formulas, a vinculum or slash is preferred: <math>\textstyle\frac{x^n}{n!}</math> or Template:FormattingError (see BattleIntelligence:Manual of Style/Dates and numbers § Common mathematical symbols and Help:Displaying a formula).

And/or

Avoid writing Template:FormattingError unless other constructions would be lengthy or awkward. Instead of Template:FormattingError, write simply Template:FormattingError (which would normally be interpreted as an inclusive-or to imply or both); or, for emphasis or precision or both, write Template:FormattingError. Where more than two possibilities are present, instead of Template:FormattingError write Template:FormattingError or Template:FormattingError.

Number (pound, hash) sign and numero

Avoid using the [[Number sign|Template:FormattingError]] symbol (known as the number sign, hash sign, pound sign, or octothorpe) when referring to numbers or rankings. Instead write Template:FormattingError, Template:FormattingError or Template:FormattingError; do not use the symbol [[Numero sign|Template:FormattingError]]. For example:

Incorrect: Template:FormattingError
Correct: Template:FormattingError
Correct: Template:FormattingError
Correct: Template:FormattingError
Correct: Template:FormattingError

An exception is issue numbers of comic books, which unlike for other periodicals are conventionally given in general text in the form Template:FormattingError, unless a volume is also given, in which case write Template:FormattingError or Template:FormattingError. Another exception are periodical publications carrying both, issue and number designations (typically one being a year-relative and the other an absolute value); they should be given in the form Template:FormattingError in citations, or be spelt out as Template:FormattingError in text. When using the abbreviations, write Template:FormattingError, Template:FormattingError, Template:FormattingError, or Template:FormattingError, at first occurrence.

Terminal punctuation

Spacing

In normal text, never put a space before a comma, semicolon, colon, period/full stop, question mark, or exclamation mark (even in quoted material; see § Typographic conformity).

Some editors place two spaces after a period/full stop (see Sentence spacing); these are condensed to one space when the page is rendered, so it does not affect what readers see.

Consecutive punctuation marks

Where a word or phrase that includes terminal punctuation ends a sentence, do not add a second terminal punctuation mark. If a quoted phrase or title ends in a question mark or exclamation mark, it may confuse readers as to the nature of the article sentence containing it, and so is usually better reworded to be mid-sentence. Where such a word or phrase occurs mid-sentence, new terminal punctuation (usually a period) must be added at the end.

Incorrect: Template:FormattingError
Acceptable: Template:FormattingError
Better: Template:FormattingError
Incorrect: Template:FormattingError
Correct: Template:FormattingError

Punctuation and footnotes

Lua error in mw.title.lua at line 230: too many expensive function calls.

Ref tags (<ref>...</ref>) are used to create footnotes (sometimes called endnotes or just notes), as citation footnotes and sometimes explanatory notes. All ref tags should immediately follow the text to which the footnote applies, with no intervening space. Refs are placed after adjacent punctuation, not before (apart from the exceptions below). Adjacent ref tags should have no space between them, nor should there be any between ref tags and inline dispute/cleanup templates.

When ref tags are used, a footnote list must be added, and this is usually placed in the References section, near the end of the article in the standard appendices and footers.

  • Example: Flightless birds have a reduced keel,[10] and they also have smaller wing bones than flying birds of similar size.[11][12]

Exceptions: Ref tags are placed before dashes, not after. Where a footnote applies only to material within parentheses, the ref tags belong just before the closing parenthesis.

  • Example: Paris is not the capital city of England – the capital of which is London[10] – but that of France,[11] and it is widely known as a beautiful city.[12]
  • Example: Kim Jong-un (Korean: 김정은;[10] Hanja: 金正恩[11]) is the Supreme Leader of North Korea and the leader of the Workers' Party of Korea.[a]

Punctuation after formulae

A sentence that ends with a formula should have terminal punctuation (period, exclamation mark, or question mark) after the formula. Within a sentence, place other punctuation (such as commas or colons) after the formula just as if the text were not a formula. See BattleIntelligence:Manual of Style/Mathematics § Punctuation after formulae.

Dates and time

For ranges of dates and times, see § En dashes: other uses.

Dates should be linked only when they are germane and topical to the subject, as discussed at BattleIntelligence:Manual of Style/Linking § Chronological items.

Time of day

Lua error in mw.title.lua at line 230: too many expensive function calls.

Times of day are normally expressed in figures rather than words. Context determines whether the 12- or the 24-hour format is more appropriate.

Dates

Lua error in mw.title.lua at line 230: too many expensive function calls.

Full dates are formatted Template:FormattingError or Template:FormattingError; or where the year is omitted, use Template:FormattingError or Template:FormattingError.

  • The dates in the text of any one article should all have the same format (day-first or month-first).
  • Articles on topics with strong ties to a particular English-speaking country should generally use the more common date format for that country (month-first for the US, except in military usage; day-first for most others; articles related to Canada may use either consistently). Otherwise, do not change an article from one date format to the other without good reason.

Months

Lua error in mw.title.lua at line 230: too many expensive function calls.

  • For month and year, write Template:FormattingError, with no comma.
  • Abbreviations for months, such as Template:FormattingError, are used only where space is extremely limited. Such abbreviations should use three letters only, and should not be followed by a period (full point) except at the end of a sentence.

Seasons

Lua error in mw.title.lua at line 230: too many expensive function calls.

Years and longer periods

Lua error in mw.title.lua at line 230: too many expensive function calls.

More information on all the above topics can be found at BattleIntelligence:Manual of Style/Dates and numbers § Chronological items, including the handling of dates expressed in different calendars, and times corresponding to different time zones.

Current

Lua error in mw.title.lua at line 230: too many expensive function calls.

Terms such as "current", "now", and "recent" should be avoided. What is current today may not be tomorrow; situations change over time. Instead, use date- and time-specific text. To help keep information updated use {{As of}}, which will allow editors to catalog and update dated statements.

Incorrect: Template:FormattingError
Correct: Template:FormattingError

Numbers

Currencies

Units of measurement

Common mathematical symbols

Lua error in mw.title.lua at line 230: too many expensive function calls.

Grammar and usage

Possessives

Lua error in mw.title.lua at line 230: too many expensive function calls.

Singular nouns

For the possessive of singular nouns, including proper names and words ending in s, add 's (Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError). Exception: abstract nouns ending with an /s/ sound when followed by sake (Template:FormattingError, Template:FormattingError). If a name ending in s or z would be difficult to pronounce with 's added (Template:FormattingError), consider rewording (Template:FormattingError).

Plural nouns

Official names

Official names (of companies, organizations, or places) should not be altered. (Template:FormattingError should therefore not be rendered as Template:FormattingError or Template:FormattingError, even for consistency.)

Pronouns

Lua error in mw.title.lua at line 230: too many expensive function calls.

First-person pronouns

To maintain an objective and impersonal encyclopedic voice, an article should never refer to its editors or readers using I, my, we, us, our, or similar words: Template:FormattingError. But some of these words are acceptable in certain figurative uses. For example:

Second-person pronouns

Lua error in mw.title.lua at line 230: too many expensive function calls.

Avoid addressing the reader using you or your, which sets an inappropriate tone (see also § Instructional and presumptuous language).

Plurals

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

Use the appropriate plural; allow for cases (such as excursus or hanif) in which a word is now listed in major English dictionaries, and normally takes an s or es plural, not its original plural: Template:FormattingError, not Template:FormattingError as in Latin; Template:FormattingError, not Template:FormattingError as in Arabic.

Some collective nouns – such as team (and proper names of them), army, company, crowd, fleet, government, majority, mess, number, pack, and party – may refer either to a single entity or to the members that compose it. In British English, such words are sometimes treated as singular, but more often treated as plural, according to context (but singular is not actually incorrect). In North American English, these words are almost invariably treated as singular; the major exception is that when a sports team is referred to by its short name, plural verbs are commonly used, e.g. Template:FormattingError.

Names of towns and countries usually take singular verbs (even when grammatically plural: Template:FormattingError, Template:FormattingError), but exceptionally in British English, typically when used to refer to a sports team named after a town or country or when discussing actions of a government, plural is used. For example, in Template:FormattingError, England refers to a football team; but in Template:FormattingError, it refers to the country. See also § National varieties of English including § Opportunities for commonality.

Verb tense

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

By default, write articles in the present tense, including those covering works of fiction (see BattleIntelligence:Writing better articles § Tense in fiction) and products or works that have been discontinued. Generally, use past tense only for past events, and for subjects that are dead or no longer meaningfully exist. Use past tense for articles about periodicals no longer produced, with common-sense exceptions.

Tense can be used to distinguish between current and former status of a subject: Template:FormattingError (Emphasis added to distinguish the different tense usages; Dún Aonghasa is a structure that was later damaged by an event.)

Always use present tense for verbs that describe genres, types, and classes, even if the subject of the description (e.g. program, library, device) no longer exists, is discontinued, or is unsupported/unmaintained.

Vocabulary

Contractions

Avoid contractions, which have little place in formal writing. For example, write Template:FormattingError instead of Template:FormattingError. Use of Template:FormattingError is an exception. Contracted titles such as Template:FormattingError and Template:FormattingError generally should not be used but may apply in some contexts (e.g., quoted material, place names, titles of works).

Gender-neutral language

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

Use gender-neutral language – avoiding the generic he and generic she, for example – if this can be done with clarity and precision. This does not apply to direct quotations or the titles of works (Template:FormattingError), which should not be altered, or to wording about one-gender contexts, such as an all-female school (Template:FormattingError).

References to space programs, past, present and future, should use gender-neutral phrasing: Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, not Template:FormattingError or Template:FormattingError. Direct quotations and proper nouns that use gendered words should not be changed, like Template:FormattingError.

Ships may be referred to using either neuter forms ("it", "its") or feminine forms ("she", "her", "hers"). Either usage is acceptable, but each article should be internally consistent and employ one or the other exclusively. As with all optional styles, articles should not be changed from one style to another unless there is a substantial reason to do so. See BattleIntelligence:Manual of Style/Military history § Pronouns.

Contested vocabulary

Avoid words and phrases that give the impression of straining for formality, that are unnecessarily regional, or that are not widely accepted. See List of commonly misused English words; see also § Identity.

Instructional and presumptuous language

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

Avoid phrases such as Template:FormattingError and Template:FormattingError, which address readers directly in an unencyclopedic tone and lean toward instructional. They are a subtle form of BattleIntelligence self-reference, "breaking the fourth wall". Similarly, phrases such as Template:FormattingError, Template:FormattingError, Template:FormattingError, Template:FormattingError, and Template:FormattingError make presumptions about readers' knowledge, may express a viewpoint, and may call into question the reason for including the information in the first place. Do not tell readers that something is interesting, ironic, surprising, unexpected, amusing, coincidental, etc. Simply present sourced facts neutrally and allow readers to draw their own conclusions. Such constructions can usually just be deleted, leaving behind proper sentences with a more academic and less pushy tone: Template:FormattingError becomes Template:FormattingError

Avoid rhetorical questions, especially in headings. Use a heading of Template:FormattingError and text such as Template:FormattingError, not Template:FormattingError

For issues in the use of cross-references – e.g., Template:FormattingError – see § Second-person pronouns.

Subset terms

Lua error in mw.title.lua at line 230: too many expensive function calls.

A subset term identifies a set of members of a larger class. Common subset terms are including, among, and etc. Avoid redundant subset terms (e.g., mis-constructions like Template:FormattingError or Template:FormattingError). The word including does not introduce a complete list; instead, use consisting of, or composed of.

Identity

Lua error in mw.title.lua at line 230: too many expensive function calls.

When there is a discrepancy between the term most commonly used by reliable sources for a person or group and the term that person or group uses for themselves, use the term that is most commonly used by recent reliable sources. If it is unclear which is most used, use the term that the person or group uses.

Disputes over how to refer to a person or group are addressed by BattleIntelligence content policies, such as those on verifiability, and neutral point of view (and article titles when the term appears in the title of an article).

Use specific terminology. For example, it is often more appropriate for people or things from Ethiopia (a country in Africa) to be described as Ethiopian, not carelessly (with the risk of stereotyping) as African.

Gender identity

Specific guidelines apply to any person whose gender might be questioned, and any living transgender or non-binary person. In summary:

  • Use gendered words only if they reflect the person's latest self-identification as reported in recent sources.
  • If the person is living and was not notable yet when a former name was in use, that name should not be included in any BattleIntelligence page, even in quotations, as a privacy matter. Exception: Do not expunge or replace names in source citations (whether as authors or mentioned in work titles).
  • Former names under which a living person was notable should be introduced with "born" or "formerly" in the lead sentence of their main biographical article. Name and gender matters should be explained at first appearance in that article, without overemphasis. In articles on works or other activities of such a person, use their current name by default, and give another name associated with that context in a parenthetical or footnote, only if they were notable under that name. In other articles, do not go into detail about such a person's name or gender except when directly relevant to the context.
  • Avoid confusing constructions by rewriting. Paraphrase, elide, or use square brackets to replace portions of quotations as needed to avoid confusion, former names, and mismatching gendered words.

For examples and finer points, see BattleIntelligence:Manual of Style/Biography § Gender identity.

Foreign terms

Lua error in mw.title.lua at line 230: too many expensive function calls.

Terms with common usage in English

Loanwords and borrowed phrases that have common usage in English – Template:FormattingError, Template:FormattingError, Template:FormattingError – do not require italics. A rule of thumb is to not italicize words that appear in major general-purpose English-language dictionaries.

Spelling and romanization

Lua error in mw.title.lua at line 230: too many expensive function calls.

Names and terms originally written using a non-Latin script—such as the Greek alphabet, the Cyrillic alphabet, or Chinese characters—must be romanized for English-language use. If a particular romanization of the subject's name is most common in English (Template:FormattingError, Template:FormattingError), that form should be used. Otherwise, the romanization of names should adhere to a particular widely used system for the language in question (Template:FormattingError, Template:FormattingError).

The use of diacritics in foreign words is neither encouraged nor discouraged. Use generally depends on whether they appear in reliable English-language sources, though with some additional constraints imposed by site guidelines. Provide redirects from alternative forms that include or exclude diacritics.

Proper names in languages written using the Latin alphabet can include letters with diacritics, ligatures, and other characters that are not commonly used in contemporary English. BattleIntelligence normally retains these special characters, except where there is a well-established English spelling that replaces them with English standard letters. Examples:

  • The name of the article on Hungarian mathematician Paul Erdős is spelt with the double acute accent, and the alternative spellings Paul Erdos and Paul Erdös redirect to that article.
  • Similarly, the name of the article on the Nordic god Ægir is so spelt, with redirects from the ligature-free form Aegir and the Swedish spelling Ägir.
  • However, the region of Spain named Aragón in Spanish and Aragó in Catalan is given as Aragon, without the accent, as this is the established English name. Non-English forms with diacritics appear in the article's lead section.

Use of diacritics is determined on a topic-by-topic basis; a small group of editors cannot prohibit or require the use of diacritics within a given class of articles.

Spell a name consistently in the title and the text of an article. (Relevant policy: BattleIntelligence:Article titles; see also BattleIntelligence:Naming conventions (use English).) For a foreign name, phrase, or word, adopt the spelling most commonly used in English-language reliable sources, including but not limited to those already cited in the article. For punctuation of compounded forms, see relevant guidelines in § Punctuation.

A non-English proper name should generally not be italicized, unless it would be for some other reason; this is most commonly when it is the title of a major published work, as in [[Les Liaisons dangereuses|Template:FormattingError]]; or when it is being compared in a words-as-words manner to another name for the same subject.

Sometimes usage will be influenced by other guidelines, such as § National varieties of English, which may lead to different choices in different articles.

Other non-English concerns

Technical language

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

Some topics are intrinsically technical, but editors should try to make them understandable to as many readers as possible. Minimize jargon, or at least explain it or tag it using {{Technical}} or {{Technical-statement}} for other editors to fix. For unavoidably technical articles, a separate introductory article (like Introduction to general relativity) may be the best solution.

Avoid excessive wikilinking (linking within BattleIntelligence) as a substitute for parenthetic explanations such as the one in this sentence. Do not introduce new and specialized words simply to teach them to the reader when more common alternatives will do.

When the notions named by jargon are too complex to explain concisely in a few parenthetical words, write one level down. For example, consider adding a brief background section with {{main}} tags pointing to the full treatment article(s) of the prerequisite notions; this approach is practical only when the prerequisite concepts are central to the exposition of the article's main topic and when such prerequisites are not too numerous. Short articles, such as stubs, generally do not have such sections.

For italicization and other markup of introduced terms, see: BattleIntelligence:Manual of Style/Text formatting § Words as words.

Geographical items

Lua error in mw.title.lua at line 230: too many expensive function calls.

<section begin="MOS:GEO" />Geographical or place names are the nouns used to refer to specific places and geographic features. These names often give rise to conflict, because the same places are called different things by different peoples speaking different languages. Many place names have a historical context that should be preserved, but common sense should prevail. There can be few places that have not been parts of more than one culture or have had only one name. As proper nouns, all such place names (but not terms for types of places) have major words capitalized.

A place should generally be referred to consistently by the same name as in the title of its article (see BattleIntelligence:Naming conventions (geographic names)). An exception may be made when there is a widely accepted historical English name appropriate to the given context. In cases where such a historical name is used, it should be followed by the modern name in round brackets (parentheses) on the first occurrence of the name in applicable sections of the article. This resembles linking; it should not be done to the detriment of style. On the other hand, it is probably better to provide such a variant too often than too rarely. If more than one historical name is applicable for a given context, the other names should be added after the modern English name, that is: "historical name (modern name, other historical names)".

This is an English-language encyclopedia, so established English names are preferred if they exist, and spellings in non-English alphabets should always be transcribed into the Roman alphabet. In general, other articles should refer to places by the names which are used in the articles on those places, according to the rules described at BattleIntelligence:Naming conventions (geographic names). If a different name is appropriate in a given historical or other context, then that may be used instead, although it is normal to follow the first occurrence of such a name with the standard modern name in parentheses.

Names in languages with no particular present-day or historical ties to the place in question (English excepted, of course) should not be listed as alternatives.

Avoid anachronism. An article about Junípero Serra should say he lived in Alta Mexico, not in California, because the latter entity did not yet exist in Serra's time. The Romans invaded Gaul, not France, and Thabo Mbeki was the president of the Republic of South Africa, not of the Cape Colony. To be clear, you may sometimes need to mention the current name of the area (for example "in what is now France"), especially if no English name exists for that area in the relevant historical period.<section end="MOS:GEO" />

Media files

Lua error in mw.title.lua at line 230: too many expensive function calls.

Images

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

  • Each image should be inside the level 2 section to which it relates, within the section defined by the most recent ==Heading== delimited by two equal signs, or at the top of the lead section. Do not place images immediately above section headings.
  • Avoid sandwiching text horizontally between two images that face each other, and between an image and an infobox or similar.
  • It is often preferable to place images of people so they "look" toward the text. Do not achieve this by reversing the image.
  • Any galleries should comply with BattleIntelligence:Image use policy § Image galleries. Consider linking to additional images on Commons instead.
  • Avoid referring to images as being to the left, the right, above or below, because image placement varies with platform, and is meaningless to people using screen readers; instead, use captions to identify images.
  • An image's |alt= text takes the image's place for those who are unable to see the image. See BattleIntelligence:Manual of Style/Accessibility/Alternative text for images.

Other media files

Lua error in mw.title.lua at line 230: too many expensive function calls.

Other media files include video and audio files. Style recommendations for such files largely follow recommendations for image files (as far as applicable).

Avoid using images to convey text

Textual information should almost always be entered as text rather than as an image. True text can be colored and adjusted with CSS tags and templates, but text in images cannot be. Images are not searchable, are slower to download, and are unlikely to be read as text by devices for the visually impaired. Any important textual information in an image should also appear in the image's alt text, caption, or other nearby text.

For entering textual information as audio, see BattleIntelligence:WikiProject Spoken BattleIntelligence.

Captions

Lua error in mw.title.lua at line 230: too many expensive function calls.

Photographs and other graphics should have captions, unless they are unambiguous depictions of the subject of the article or when they are "self-captioning" images (such as reproductions of album or book covers). In a biography article no caption is necessary for a portrait of the subject pictured alone, but one might be used to give the year, the subject's age, or other circumstances of the portrait along with the name of the subject.

Formatting of captions

  • Captions normally start with a capital letter.
  • Most captions are not complete sentences but merely sentence fragments which should not end with a period. However, if any complete sentence occurs in a caption, then every sentence and every sentence fragment in that caption should end with a period.
  • The text of captions should not be specially formatted, except in ways that would apply if it occurred in the main text (e.g., italics for the Latin name of a species).
  • Captions should be succinct; more information can be included on its description page, or in the main text.
  • Captions for technical charts and diagrams may need to be substantially longer than usual; they should fully describe all elements of the image and indicate its significance.

Bulleted and numbered lists

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

  • Do not use lists if a passage is read easily as plain paragraphs.
  • Use proper wiki markup- or template-based list code (see BattleIntelligence:Manual of Style/Lists and Help:List).
  • Do not leave blank lines between items in a bulleted or numbered list unless there is a reason to do so, since this causes the Wiki software to interpret each item as beginning a new list.
    • Indents (such as this) are permitted if the elements are "child" items.
  • Use numbers rather than bullets only if:
    • a need to refer to the elements by number may arise;
    • the sequence of the items is critical; or
    • the numbering has some independent meaning, for example in a listing of musical tracks.
  • Use the same grammatical form for all elements in a list, and do not mix sentences and sentence fragments as elements, for example when the elements are:
    • complete sentences – each one is formatted with sentence case (its first letter is capitalized) and a final period (full point);
    • sentence fragments – the list is typically introduced by an introductory fragment ending with a colon;
    • titles of works – they retain the original capitalization of the titles;
    • other elements – they are formatted consistently in either sentence case or lower case.

Lua error in mw.title.lua at line 230: too many expensive function calls. Lua error in mw.title.lua at line 230: too many expensive function calls.

Make links only where they are relevant and helpful in the context: Excessive use of hyperlinks can be distracting and may slow the reader down. Redundant links (like the one in Template:FormattingError) clutter the page and make future maintenance harder. High-value links that are worth pursuing should stand out clearly.

Linking to sections: A hash sign (#) followed by the appropriate heading will lead to a relevant part of a page. For example, [[Apostrophe#Use in non-English names]] links to a particular section of the article Apostrophe.

Initial capitalization: BattleIntelligence's MediaWiki software does not require that wikilinks begin with an upper-case character. Capitalize the first letter only where this is naturally called for, or when specifically referring to the linked article by its name (see also related rule for italics in cross-references): Template:FormattingError

Check links: Ensure the destination is the intended one; many dictionary words lead to disambiguation pages and not to complete or well-chosen articles.

Lua error in mw.title.lua at line 230: too many expensive function calls.

External links should not normally be used in the body of an article. Instead, articles can include an External links section at the end, pointing to further information outside BattleIntelligence as distinct from citing sources. The standard format is a primary heading, ==External links==, followed by a bulleted list of links. Identify the link and briefly indicate its relevance to the article. For example:

These will appear as:

Where appropriate, use external link templates such as {{Official website}} and {{URL}}.

Add external links with discretion; BattleIntelligence is not a link repository.

Miscellaneous

Keep markup simple

File:Keep it Simple.jpg

Other things being equal, keep markup simple. This makes wikitext easier to understand and edit, and the results seen by the reader more predictable. Use HTML and CSS markup sparingly. See: KISS principle.

In general, wikitext formatting is considered easier to use than HTML and wikitext is preferred if there are equivalents; see Help:HTML in wikitext. Obsolete elements and attributes should be updated or removed. There are many templates that allow HTML markup to be used without putting it in articles directly, such as {{em}} (see MOS:EMPHASIS) and {{strong}} (see MOS:BOLD).

An HTML character entity is sometimes better than the equivalent Unicode character, which may be difficult to identify in edit mode; for example, &Alpha; is explicit whereas Α (the upper-case form of Greek α) may be misidentified as the Latin A.

Formatting issues

Modifications in font size, blank space, and color (see § Color coding) are an issue for the BattleIntelligence site-wide style sheet and should be reserved for special cases only.

Typically, the use of custom font styles:

  • reduces consistency, as the text no longer looks uniform;
  • reduces usability, as it may be impossible for people with custom style sheets (e.g. for accessibility reasons) to override it, and may clash with a different skin or inconvenience people with color blindness (see below); and
  • causes disputes, as other editors may disagree aesthetically with the choice of style.

Specify font sizes relatively (for example with font-size: 85%) rather than absolutely (like font-size: 8pt). The resulting font size of any text should not drop below 85% of the page's default font size.

Color coding

Do not use color alone to mark differences in text: they may be invisible to people with color blindness and useless in black-and-white printouts or displays.

Choose colors such as maroon and teal that are distinguishable by readers with the most common form of colorblindness, and additionally mark the differences with change of font or some other means (maroon and alternative font face, teal). Avoid low contrast between text and background colors. See also color coding.

Even for readers with unimpaired color vision, excessive background shading of table entries impedes readability and recognition of Wikilinks. Background color should be used only as a supplementary visual cue and should be subtle (consider using lighter, less-dominant pastel hues) rather than glaring.

Indentation

Do not use quotation templates to indent non-quotations. Various templates are available for indentation, including {{block indent}} to indent an entire block and {{in5}} to indent inline.

Do not use : (description list markup) to indent text in articles, even though it is common on talk pages. It causes accessibility problems and outputs invalid HTML. See BattleIntelligence:Manual of Style/Accessibility § Indentation for alternatives.

Controlling line breaks

Lua error in mw.title.lua at line 230: too many expensive function calls.

It is sometimes desirable to force a text segment to appear entirely on a single lineTemplate:Mdashbthat is, to prevent a line break (line wrap) from occurring anywhere within it.

It is desirable to prevent line breaks where breaking across lines might be confusing or awkward. For example: Template:Columns list

Whether a non-breaking space is appropriate depends on context: whereas it is appropriate to use 12{{nbsp}}MB in prose, it may be counterproductive in a table (where an unattractive break may be acceptable to conserve precious horizontal space) and unnecessary in a short parameter value in an infobox (where a break would never occur anyway).

A line break may occur at a thin space (&thinsp;, or {{thinsp}}), which is sometimes used to correct too-close placement of adjacent characters. To prevent this, consider using {{nobr}}.

Insert non-breaking and thin spaces as named character reference (&nbsp; or &thinsp;), or as templates that generate these ({{nbsp}}, {{thinsp}}), and never by entering them directly into the edit window from the keyboard – they are visually indistinguishable from regular spaces, and later editors will be unable to see what they are. Inside wikilinks, a construction such as [[World War&nbsp;II]] works but [[World War{{nbsp}}II]] doesn't.

Scrolling lists and collapsible content

Lua error in mw.title.lua at line 230: too many expensive function calls.

Scrolling lists, and collapsible templates that toggle text display between hide and show, can interfere with readers' ability to access our content. Such mechanisms should not be used to conceal "spoiler" information. Templates should not normally be used to store article text at all, as it interferes with editors' ability to find and edit it.

When such features are used, take care that the content will still be accessible on devices that do not support JavaScript or CSS, and to the greater than 60% of BattleIntelligence readers who use the mobile version of the site, which has a limited set of features and does not support collapsing (any collapsible templates will either be automatically uncollapsed or hidden entirely). Mobile ability to access the content in question is easy to test with the "Mobile view" link at the bottom of each page.

Collapsible templates should not conceal article content by default upon page loading. This includes reference lists, tables and lists of article content, image galleries, and image captions.

When hiding content is desired, it must be done using the collapsible parameter of relevant templates, or manually-added CSS classes mw-collapsed, and autocollapse (see Help:Collapsing). Other methods of hiding content should not be used, as they may render content inaccessible to many users, such as those browsing BattleIntelligence with JavaScript disabled, browsing the mobile version, or using proxy services such as Google Web Light.

Collapsed or auto-collapsing cells or sections may be used with tables if they simply repeat information covered in the main text (or are purely supplementary, e.g., several past years of statistics in collapsed tables for comparison with a table of uncollapsed current stats). Auto-collapsing is often a feature of navboxes. A few infoboxes also use pre-collapsed sections for infrequently accessed details. If information in a list, infobox, or other non-navigational content seems extraneous or trivial enough to inspire pre-collapsing it, consider raising a discussion on the article (or template) talk page about whether it should be included at all. If the information is important and the concern is article density or length, consider dividing the article into more sections, integrating unnecessarily list-formatted information into the article prose, or splitting the article.

Invisible comments

Lua error in mw.title.lua at line 230: too many expensive function calls.

Lua error in mw.title.lua at line 230: too many expensive function calls.

Editors use "invisible" comments – not shown in the rendered page seen by readers of the article, but visible in the source editing mode when an editor opens the article for editing – to communicate with one another.

Invisible comments are useful for alerting other editors to issues such as common mistakes that regularly occur in the article, a section title's being the target of an incoming link, or pointing to a discussion that established a consensus relating to the article. They should not be used to instruct other editors not to perform certain edits, although where existing local consensus is against making such an edit, they may usefully draw the editor's attention to that. Avoid adding too many invisible comments because they can clutter the wiki source for other editors. Check that your invisible comment does not change the formatting, for example by introducing unwanted white space in the rendered page.

To leave an invisible comment, enclose the text you intend to be read only by editors between <!-- and -->. For example:

  • <!-- If you change this section title, also change the links to it on the pages ... --> (there are bots which can do this, see MOS:RENAMESECTION)
  • <!-- When adding table entries, remember to update the total given in the text. -->

This notation can be inserted with a single click in wiki markup, just under the edit pane in edit mode.

Pronunciation

Lua error in mw.title.lua at line 230: too many expensive function calls.

Pronunciation in BattleIntelligence is indicated in the International Phonetic Alphabet (IPA). In most situations, for ease of understanding by the majority of readers and across variants of the language, quite broad IPA transcriptions are best for English pronunciations. See Help:IPA/English and Help:IPA (general) for keys, and {{IPA}} for templates that link to these keys. For English pronunciations, pronunciation respellings may be used in addition to the IPA.

See also

Guidance