Difference between revisions of "Help:Style guide"
m (→Overlinking and underlinking) |
m |
||
Line 1: | Line 1: | ||
{{Help navbar}} | {{Help navbar}} | ||
− | Depending on which writing [[Wikipedia:Style_guide|style]] people have been taught in school and which region they are from, there are going to be differences in opinion about how words are typed and used on | + | This article is a '''style guide'''. Depending on which writing [[Wikipedia:Style_guide|style]] people have been taught in school and which region they are from, there are going to be differences in opinion about how words are typed and used on the TF Wiki. |
− | This guide will hopefully help people adhere to a consistent standard of style and formatting throughout TF Wiki articles. Covering all situations would take a long time and the following is only meant to be a reference for TF Wiki specific guidelines. For a complete | + | This guide will hopefully help people adhere to a consistent standard of style and formatting throughout the TF Wiki articles. Covering all situations would take a long time and the following is only meant to be a reference for the TF Wiki specific guidelines. For a complete Manual of Style, the [[Wikipedia:Wikipedia:Manual_of_Style|Wikipedia Manual of Style]] should be consulted. |
Line 9: | Line 9: | ||
==Article titles== | ==Article titles== | ||
− | Article titles should be short, simple and to the point. As a general rule, the first word should be capitalized and any subsequent words should be lowercase. However, this isn't a hard and fast rule and some words may be capitalized to adhere to other guidelines (''see [[Help:Team Fortress Wiki style guide#Specific wording|Specific wording]]''). Superfluous words such as "properly", "correctly", and "the right way" should be avoided, as should the use of pronunciation marks. Articles are usually on one subject so the title should not be on multiple topics. | + | Article titles should be short, simple, and to the point. As a general rule, the first word should be capitalized and any subsequent words should be lowercase. However, this isn't a hard and fast rule and some words may be capitalized to adhere to other guidelines (''see [[Help:Team Fortress Wiki style guide#Specific wording|Specific wording]]''). Superfluous words such as "properly", "correctly", and "the right way" should be avoided, as should the use of pronunciation marks. Articles are usually on one subject so the title should not be on multiple topics. |
'''Examples of good titles''' | '''Examples of good titles''' | ||
Line 36: | Line 36: | ||
==General writing style== | ==General writing style== | ||
− | Articles should be written in the third person if possible. While writing on TF Wiki doesn't need to be neutral, you should try to avoid personal reference. Sentences such as "I like to duck behind the boxes because it gives me better cover" could easily be phrased as "Ducking behind the boxes provides better cover". | + | Articles should be written in the third person if possible. While writing on the TF Wiki doesn't need to be neutral, you should try to avoid personal reference. Sentences such as, "I like to duck behind the boxes because it gives me better cover" could easily be phrased as "Ducking behind the boxes provides better cover". |
Formatting functions like '''bold''', ''italics'', and [[Wikipedia:How to edit a page#Links and URLs|linking]] are provided to improve readability of articles, so use them (''see [[Wikipedia:Wikipedia:Cheatsheet|Wikipedia cheatsheet]] for additional help''). If you wish to emphasize a word use ''italics'' rather than '''bold''' or CAPITALS. Use of the bold face type should be limited within an article whenever possible to definitions, table headers, and name highlighting (although names should only be highlighted once in an article). Double emphasis should also be avoided but can be used for text such as important warnings by making the word '''''bold italic'''''. Italics and quotation marks are also used in names of pieces of media. For example, game names are italicized. | Formatting functions like '''bold''', ''italics'', and [[Wikipedia:How to edit a page#Links and URLs|linking]] are provided to improve readability of articles, so use them (''see [[Wikipedia:Wikipedia:Cheatsheet|Wikipedia cheatsheet]] for additional help''). If you wish to emphasize a word use ''italics'' rather than '''bold''' or CAPITALS. Use of the bold face type should be limited within an article whenever possible to definitions, table headers, and name highlighting (although names should only be highlighted once in an article). Double emphasis should also be avoided but can be used for text such as important warnings by making the word '''''bold italic'''''. Italics and quotation marks are also used in names of pieces of media. For example, game names are italicized. | ||
Line 48: | Line 48: | ||
===Overlinking and underlinking=== | ===Overlinking and underlinking=== | ||
− | For a complete guide to linking please refer to Wikipedia's [[Wikipedia:Wikipedia:Manual_of_Style_%28links%29|Manual of Style (links)]]. | + | For a complete guide to linking, please refer to Wikipedia's [[Wikipedia:Wikipedia:Manual_of_Style_%28links%29|Manual of Style (links)]]. |
The use of links is a difficult balance between providing the reader enough useful links to allow them to "wander through" articles and excessive linking which can distract them from their reading flow. | The use of links is a difficult balance between providing the reader enough useful links to allow them to "wander through" articles and excessive linking which can distract them from their reading flow. | ||
Line 54: | Line 54: | ||
Underlinking can cause the reader to become frustrated because questions may arise about the article's contents which can only be resolved by using the search option or other sources for clarification, interrupting and distracting the reader. | Underlinking can cause the reader to become frustrated because questions may arise about the article's contents which can only be resolved by using the search option or other sources for clarification, interrupting and distracting the reader. | ||
− | Overlinking may distract the reader because links are usually colored differently causing the eye to shift focus constantly. Additionally if the same word is linked multiple times in the same paragraph it can cause the reader to question if the links are directing them to different articles or not. | + | Overlinking may distract the reader because links are usually colored differently causing the eye to shift focus constantly. Additionally, if the same word is linked multiple times in the same paragraph it can cause the reader to question if the links are directing them to different articles or not. |
The guidelines for linking are: | The guidelines for linking are: | ||
Line 63: | Line 63: | ||
==Spelling== | ==Spelling== | ||
− | National variations of English will occur depending on the nationality of the author. There is no preferred variation for articles and users should be aware of this, however consistency should be maintained. If the article was written in American English then this form should be used throughout | + | National variations of English will occur depending on the nationality of the author. There is no preferred variation for articles and users should be aware of this, however consistency should be maintained. If the article was written in American English, then this form should be used throughout – British English, Canadian English, or Australian English users should not change to their variation part way through. |
− | If possible try to avoid the situation altogether by using common substitutions, for instance | + | If possible try to avoid the situation altogether by using common substitutions, for instance "analyze the situation" could be changed to "examine the situation". |
This does not extend to the discussion pages where users can use variations freely. | This does not extend to the discussion pages where users can use variations freely. | ||
Line 79: | Line 79: | ||
===Classes, items, and terms=== | ===Classes, items, and terms=== | ||
− | Names of the ''Team Fortress 2'' [[class]]es will generally be capitalized ([[Engineer]], [[Spy]], etc). Normally English nouns within a sentence are lowercased (engineer and spy); however, when referred to within the context of ''Team Fortress 2'', they are treated as [[Wikipedia:Noun#Proper nouns and common nouns|proper nouns]] and thus capitalized. Words and abbreviations of specific names should be capitalized unless referring to things that have become general types (see health example below). This will also apply to names of [[weapons]], [[hats]] and terms (''see [[:Category:Glossary|glossary]]'') within ''Team Fortress 2'', however if the name has more than one word, any successive words should be title-cased. | + | Names of the ''Team Fortress 2'' [[class]]es will generally be capitalized ([[Engineer]], [[Spy]], etc). Normally, English nouns within a sentence are lowercased (engineer and spy); however, when referred to within the context of ''Team Fortress 2'', they are treated as [[Wikipedia:Noun#Proper nouns and common nouns|proper nouns]] and thus capitalized. Words and abbreviations of specific names should be capitalized unless referring to things that have become general types (see health example below). This will also apply to names of [[weapons]], [[hats]], and terms (''see [[:Category:Glossary|glossary]]'') within ''Team Fortress 2'', however if the name has more than one word, any successive words should be title-cased. |
− | Also keep in mind to avoid using and including unnecessary definite articles. For instance, avoid creating pages with titles such as; "The Hound Dog", "The Gentlemanne's Service Medal" | + | Also keep in mind to avoid using and including unnecessary definite articles. For instance, avoid creating pages with titles such as; "The Hound Dog", "The Gentlemanne's Service Medal", "The Pain Train", etc. Instead, use titles such as the following: "Hound Dog", "Gentlemanne's Service Medal", "Pain Train", etc. |
'''Examples''' | '''Examples''' | ||
Line 87: | Line 87: | ||
*Butterfly Knife, ''not'' Butterfly knife | *Butterfly Knife, ''not'' Butterfly knife | ||
*Critical hit, ''not'' Critical Hit (also Crit, ''not'' crit) | *Critical hit, ''not'' Critical Hit (also Crit, ''not'' crit) | ||
− | *Health, ''not'' health - when referring to the Health pickup (however health when used generally as in "the player's health") | + | *Health, ''not'' health - when referring to the Health pickup (however, health when used generally as in "the player's health") |
− | When writing about weapons, the unifying term for held ammo is 'clip' for the sake of convenience, even in cases where it may not technically 'fit' the weapon, e.g. Grenade/Rocket Launcher. This also applies to ammo | + | When writing about weapons, the unifying term for held ammo is 'clip' for the sake of convenience, even in cases where it may not technically 'fit' the weapon, e.g. Grenade/Rocket Launcher. This also applies to ammo for Sentry Guns. |
===Patches=== | ===Patches=== | ||
Line 95: | Line 95: | ||
===Strategy pages=== | ===Strategy pages=== | ||
− | Strategy pages contain advice instead of neutral statements about gameplay, so writing "you | + | Strategy pages contain advice instead of neutral statements about gameplay, so writing "you" giving commands, being accurate and being brief, are preferred to encyclopedic language. Whenever applicable, the scope of a strategy should be specified. In some cases, this will require phrases that are normally weasel words, such as "probably" and "on occasion." |
− | Many strategies will be impossible to cite, so use judgment. | + | Many strategies will be impossible to cite, so use judgment. The best strategy entries will apply universally and will not require enemy players to be stupid, inexperienced or foolish. For example, strategies requiring deception are poor advice because they will never work against excellent players. Success in general can be a poor measuring stick, since any strategy will work against sufficiently poor enemies. Give advice that would succeed against the best possible foes. |
===Unique cases=== | ===Unique cases=== | ||
In order to avoid ambiguity, certain considerations should be followed for specific topics and words. | In order to avoid ambiguity, certain considerations should be followed for specific topics and words. | ||
− | *'''"Binds":''' Many players don't play on PC, and even those that do often times don't use default key assignments. References to commands should refer to those commands in simple, bind-neutral terms, including default key assignments only as extra information (possibly added in parentheses, and not repeated at additional mentions of the same command within the article). For example, "hit mouse2 and sneak around them" would be more appropriately phrased "sneak around them by using cloak (default key mouse2 on PC, left trigger on XBox 360, L2 on PS3)" or, if recently described with key bindings already, simply "sneak around them by using cloak." | + | *'''"Binds":''' Many players don't play on a PC, and even those that do often times don't use default key assignments. References to commands should refer to those commands in simple, bind-neutral terms, including default key assignments only as extra information (possibly added in parentheses, and not repeated at additional mentions of the same command within the article). For example, "hit mouse2 and sneak around them" would be more appropriately phrased "sneak around them by using cloak (default key mouse2 on PC, left trigger on XBox 360, L2 on PS3)" or, if recently described with key bindings already, simply "sneak around them by using cloak." |
+ | |||
*'''"Pipe bomb":''' The phrase "pipe bomb" and similar terms should be avoided. Many players think of the [[Grenade Launcher]] upon reading the phrase, while game coding uses the phrase "pipes" to describe [[Sticky Bomb Launcher|stickies]]. For example, phrases like "pipes do not suffer damage fall-off" and "use cloak to get past pipes" would be more appropriately phrased "Grenades do not suffer damage fall-off" and "use cloak to get past Stickies." | *'''"Pipe bomb":''' The phrase "pipe bomb" and similar terms should be avoided. Many players think of the [[Grenade Launcher]] upon reading the phrase, while game coding uses the phrase "pipes" to describe [[Sticky Bomb Launcher|stickies]]. For example, phrases like "pipes do not suffer damage fall-off" and "use cloak to get past pipes" would be more appropriately phrased "Grenades do not suffer damage fall-off" and "use cloak to get past Stickies." | ||
+ | |||
*'''"Primary" and "Secondary" weapons''': ''Team Fortress 2'' is inconsistent in the ordering of weapons, particularly those of [[Demoman]] and [[Spy]]. Using the phrases "primary" and "secondary" to describe their weapons should be avoided. For example, "switch to primary weapon to fight nearby enemies" would be more appropriately phrased "switch to Grenade Launcher to fight nearby enemies." | *'''"Primary" and "Secondary" weapons''': ''Team Fortress 2'' is inconsistent in the ordering of weapons, particularly those of [[Demoman]] and [[Spy]]. Using the phrases "primary" and "secondary" to describe their weapons should be avoided. For example, "switch to primary weapon to fight nearby enemies" would be more appropriately phrased "switch to Grenade Launcher to fight nearby enemies." | ||
Revision as of 02:38, 4 August 2011
|
This article is a style guide. Depending on which writing style people have been taught in school and which region they are from, there are going to be differences in opinion about how words are typed and used on the TF Wiki.
This guide will hopefully help people adhere to a consistent standard of style and formatting throughout the TF Wiki articles. Covering all situations would take a long time and the following is only meant to be a reference for the TF Wiki specific guidelines. For a complete Manual of Style, the Wikipedia Manual of Style should be consulted.
Contents
Article titles
Article titles should be short, simple, and to the point. As a general rule, the first word should be capitalized and any subsequent words should be lowercase. However, this isn't a hard and fast rule and some words may be capitalized to adhere to other guidelines (see Specific wording). Superfluous words such as "properly", "correctly", and "the right way" should be avoided, as should the use of pronunciation marks. Articles are usually on one subject so the title should not be on multiple topics.
Examples of good titles
- Engineer responses
- Rocket jumping
- Control point
- Linux dedicated server
Examples of bad titles
- Soldier - The Rocket Jump Guide
- KILL ALL SPYCRABS!!!
- The Best Way To Take Out a Sniper and then Capture the Point
- Destroying a Sentry Gun correctly ("correctly" is superfluous, why would there be an "incorrect" way?)
Introduction
The introduction of a TF Wiki article is the section before the first heading. The table of contents, if displayed, appears between the lead section and the first headline.
The lead should be capable of standing alone as a concise overview of the article, briefly describing its most important points. It should contain up to four paragraphs and should be written in a clear, accessible style so as to invite a reading of the full article.
The article's subject should be mentioned at the earliest natural point in the prose in the first sentence, and should appear in boldface. For example:
The Valve Steam and game statistics allows Valve to monitor player and server statistics through Steam.
General writing style
Articles should be written in the third person if possible. While writing on the TF Wiki doesn't need to be neutral, you should try to avoid personal reference. Sentences such as, "I like to duck behind the boxes because it gives me better cover" could easily be phrased as "Ducking behind the boxes provides better cover".
Formatting functions like bold, italics, and linking are provided to improve readability of articles, so use them (see Wikipedia cheatsheet for additional help). If you wish to emphasize a word use italics rather than bold or CAPITALS. Use of the bold face type should be limited within an article whenever possible to definitions, table headers, and name highlighting (although names should only be highlighted once in an article). Double emphasis should also be avoided but can be used for text such as important warnings by making the word bold italic. Italics and quotation marks are also used in names of pieces of media. For example, game names are italicized.
- Do not use
- ALL CAPS
- Instant messenger language abbreviations - R U OK?
- Emoticons - :)
- Excessive punctuation - !!!
- Sentences starting with lowercase - "place the sentry in the corner"
Overlinking and underlinking
For a complete guide to linking, please refer to Wikipedia's Manual of Style (links).
The use of links is a difficult balance between providing the reader enough useful links to allow them to "wander through" articles and excessive linking which can distract them from their reading flow.
Underlinking can cause the reader to become frustrated because questions may arise about the article's contents which can only be resolved by using the search option or other sources for clarification, interrupting and distracting the reader.
Overlinking may distract the reader because links are usually colored differently causing the eye to shift focus constantly. Additionally, if the same word is linked multiple times in the same paragraph it can cause the reader to question if the links are directing them to different articles or not.
The guidelines for linking are:
- No more than 10 percent of the words in an article are contained in links.
- Unless it affects the sentence's wording and readability in a negative way, two links should not be next to each other in the text, so that it looks like one link - such as Spy's disguise.
- Links for any single term should not be excessively repeated in the same article. Excessive linking is defined as multiple use of the same term, in a line or a paragraph, which will almost certainly appear needlessly on the viewer's screen. Remember, the purpose of links is to direct the reader to a new spot at the point(s) where the reader is most likely to take a temporary detour due to needing more information.
- Duplicating an important link distant from a previous occurrence in an article may well be appropriate. If an important term appears many times in a long article, but is only linked once at the very beginning of the article, it may actually be underlinked. Indeed, readers who jump directly to a subsection of interest must still be able to find a link. But take care in fixing such problems, the distance between duplicate links is an editor's preference, however if in doubt duplicate the term further down the article.
Spelling
National variations of English will occur depending on the nationality of the author. There is no preferred variation for articles and users should be aware of this, however consistency should be maintained. If the article was written in American English, then this form should be used throughout – British English, Canadian English, or Australian English users should not change to their variation part way through.
If possible try to avoid the situation altogether by using common substitutions, for instance "analyze the situation" could be changed to "examine the situation".
This does not extend to the discussion pages where users can use variations freely.
General spelling and grammar should be legible and correct. Use the preview button to check your work for errors before you submit your edit. If English is not your first language or you have difficulties with writing, it is recommended you bring up your point in discussion so that other editors may add it. This makes copy-editing additions much easier.
Specific wording
Team Fortress Wiki
When using the name of the wiki in articles, the name should be used in two ways:
- Short hand
- TF Wiki (not TFWiki)
- Long hand
- Team Fortress Wiki
Classes, items, and terms
Names of the Team Fortress 2 classes will generally be capitalized (Engineer, Spy, etc). Normally, English nouns within a sentence are lowercased (engineer and spy); however, when referred to within the context of Team Fortress 2, they are treated as proper nouns and thus capitalized. Words and abbreviations of specific names should be capitalized unless referring to things that have become general types (see health example below). This will also apply to names of weapons, hats, and terms (see glossary) within Team Fortress 2, however if the name has more than one word, any successive words should be title-cased.
Also keep in mind to avoid using and including unnecessary definite articles. For instance, avoid creating pages with titles such as; "The Hound Dog", "The Gentlemanne's Service Medal", "The Pain Train", etc. Instead, use titles such as the following: "Hound Dog", "Gentlemanne's Service Medal", "Pain Train", etc.
Examples
- Sentry Gun, not Sentry gun (also Sentries, not sentries)
- Butterfly Knife, not Butterfly knife
- Critical hit, not Critical Hit (also Crit, not crit)
- Health, not health - when referring to the Health pickup (however, health when used generally as in "the player's health")
When writing about weapons, the unifying term for held ammo is 'clip' for the sake of convenience, even in cases where it may not technically 'fit' the weapon, e.g. Grenade/Rocket Launcher. This also applies to ammo for Sentry Guns.
Patches
When adding data that has been recently changed or added via patch, do not add a note stating that it was added on the '[Date] Patch' but write as if the new data was always the norm, unless the old data is somehow relevant. This is to avoid pages that talk about "recently patched data" which is now years old, as well as articles that have long sections of outdated information followed by "However this was patched and now does not work". Team Fortress 2 is constantly being patched and updated, and changes to aspects of the game become all too frequent to mention specifically.
Strategy pages
Strategy pages contain advice instead of neutral statements about gameplay, so writing "you" giving commands, being accurate and being brief, are preferred to encyclopedic language. Whenever applicable, the scope of a strategy should be specified. In some cases, this will require phrases that are normally weasel words, such as "probably" and "on occasion."
Many strategies will be impossible to cite, so use judgment. The best strategy entries will apply universally and will not require enemy players to be stupid, inexperienced or foolish. For example, strategies requiring deception are poor advice because they will never work against excellent players. Success in general can be a poor measuring stick, since any strategy will work against sufficiently poor enemies. Give advice that would succeed against the best possible foes.
Unique cases
In order to avoid ambiguity, certain considerations should be followed for specific topics and words.
- "Binds": Many players don't play on a PC, and even those that do often times don't use default key assignments. References to commands should refer to those commands in simple, bind-neutral terms, including default key assignments only as extra information (possibly added in parentheses, and not repeated at additional mentions of the same command within the article). For example, "hit mouse2 and sneak around them" would be more appropriately phrased "sneak around them by using cloak (default key mouse2 on PC, left trigger on XBox 360, L2 on PS3)" or, if recently described with key bindings already, simply "sneak around them by using cloak."
- "Pipe bomb": The phrase "pipe bomb" and similar terms should be avoided. Many players think of the Grenade Launcher upon reading the phrase, while game coding uses the phrase "pipes" to describe stickies. For example, phrases like "pipes do not suffer damage fall-off" and "use cloak to get past pipes" would be more appropriately phrased "Grenades do not suffer damage fall-off" and "use cloak to get past Stickies."
- "Primary" and "Secondary" weapons: Team Fortress 2 is inconsistent in the ordering of weapons, particularly those of Demoman and Spy. Using the phrases "primary" and "secondary" to describe their weapons should be avoided. For example, "switch to primary weapon to fight nearby enemies" would be more appropriately phrased "switch to Grenade Launcher to fight nearby enemies."