Difference between revisions of "Editing Guidelines"

From comp.tf
Jump to navigation Jump to search
(→‎Guidelines: emphasizing the third person thing.)
 
(21 intermediate revisions by 8 users not shown)
Line 3: Line 3:
 
These are the '''Editing Guidelines''' for those wishing to contribute to the wiki.  Please read them before editing pages.
 
These are the '''Editing Guidelines''' for those wishing to contribute to the wiki.  Please read them before editing pages.
  
=Guidelines=
+
== Guidelines ==
* Please remember to write ALL ARTICLES in the '''''third person''.''' This means no usage of first or second person pronouns (I, you, me, us, we, etc). If it helps, write as if you're teaching someone how the game ''is played'', not ''how to play it.'' Example: "Engineers often do so-and-so," instead of "As an engineer, you should do so-and-so."
+
* <span style="color:#c9191d">'''All articles</span> are to be writen in third person'''. No "I, you, me, us, we". etc.<br />
 +
:<small>''If it helps, write as if you are teaching someone how the game ''is played'', not ''how to play it.'' Example: “Engineers often do so-and-so”, instead of “As an Engineer, you should do so-and-so.”''</small>
  
* Keep in mind this is not a NA centric or EU centric wiki, so if you add info relevant to both scenes, make a way for a scene specific version of that article or add subtopics for each scene if needed. (Ex: Map list, Weapon list, etc...)
+
* There are more scenes out there than just the one you are on about. '''Include things that may be different across scenes'''. ({{abbr|eg|for example}}: Map list, Map rules, Weapon list, etc...)
  
* Avoid opinions and unsupported generalizations. If people disagree with you, it's not something that belongs in a wiki (unless you present it as an opinion, ie. "It is believed by some soldiers that the Black Box is useful for roaming" versus "I like the Black Box, it's great for roamers.  Try it out!" ).
+
* '''Avoid opinions''' and unsupported generalizations.
 +
:<small>''If people disagree with you, it is not something that belongs in a wiki (unless you present it as an opinion, ie. “It is believed by some soldiers that the Black Box is useful for roaming” versus “I like the Black Box, it's great for roamers.  Try it out!).''</small>
  
* There are always going to be controversial topics, like strategies, loadout choices, weapon and offclass choices, etc, but because we are a competitive wiki we aim to help new players as much as possible, so guides and guidelines for classes / strategies can be added even if they are controversial, in a constantly changing game like ours would be almost impossible to set in stone that this or that strategy is 100% sure and not biased, just make sure to create new sections or appropriate pages with common sense, for example a very specific spy guide writed by a specific player won't obviously be unbiased and 100% right but it's still a great potential resource for new players if added and tagged accordingly as so.
+
* There are always going to be controversial topics like strategies, loadout choices, weapon and offclass choices etc., but because we are a competitive wiki, we aim to help new players as much as possible, so guides and guidelines for classes / strategies can be added even if they are controversial, in a constantly changing game like ours would be almost impossible to set in stone that this or that strategy is 100% sure and not biased. Just make sure to create new sections or appropriate pages with common sense. For example, a very specific spy guide, writed by a specific player, won't obviously be unbiased and 100% right, but it is still a great potential resource for new players if added and tagged accordingly as so.
  
* Use the discussion tabs on each page to discuss possible changes/updates or suggestions to those pages.
+
* Use the discussion tabs on each page to discuss possible changes / updates or suggestions to those pages.
  
* Make sure to add a brief summary of your edits so everyone can keep up with what's going on. I cannot stress enough how helpful it is to moderators if you tell us what you're doing so we don't have to look through the whole article guessing where the +4 bytes next to your edit came from and making sure you didn't write something inappropriate somewhere.
+
* '''Summarise your edits'''.
 +
: ''<small>This is for easier revision and moderating purposes.</small>''
  
===Templates===
+
* '''Add references''' if you can, and if applicable.
Templates help make pages pretty and user-friendly and you should learn how to use them and use them whenever you can.
 
To learn how templates work and what they do please go [http://meta.wikimedia.org/wiki/Help:A_quick_guide_to_templates here] or [http://meta.wikimedia.org/wiki/Help:Template here]
 
* '''Use templates for pages when available, they are really easy to use and make pages much more user friendly'''
 
**Here are some examples of the current existing templates:
 
***[[Template:Player_infobox|Player Info Box]]
 
***[[Template:Weekmaps|This week maps table]]
 
***[[Template:6s_team_roster|6v6 Team Roster table]]
 
***[[Template:Team_infobox|Team Infobox]]
 
***[[Template:Map_infobox|Map Infobox]]
 
***[[Template:League_infobox|League Infobox]]
 
***Weapon Templates
 
****[[Template:Class_Weapon_Table_Row|Class Weapon Table_Row]]
 
****[[Template:Class_Weapon_Table_Header|Class Weapon Table Header]]
 
****[[Template:Class_Weapon_Table_End|Class Weapon Table End]]
 
  
* You are free to create your own templates when necessary, be sure to maintain consistency in colors and format across the wiki and write guidelines for the template usage in the template page, an example of a well elaborated template can be seen [[Template:Player_infobox|here]], notice the usage guidelines and the ready to copy template as well as an example given.
+
* Try to group multiple edits of the same page into a '''single edit'''. We encourage using the "Show Preview" button and proof reading.
 +
: ''<small>This is for easier revision and moderating purposes. Sometimes things slip though, so don't worry if you have that one off.</small>''
  
===Starting a New Page===
+
* '''Categorise''' your page/templates/images and keep them consistent across the board.
 +
: ''<small>If you're unsure of what Category to use, look at other examples of the same thing, ask our staff or simply make a reasonable one yourself.</small>''
  
Please follow these guidelines when creating a page on the wiki.
+
* '''Always''' add [[:Category:Maintenance_templates|Maintenance Templates]] to pages accordingly.
  
* '''First, make sure it's a topic that needs its own page''':
+
* '''Use Templates''' for pages when available.
# Does the page already exist?  It may not have the exact name you want to use (ie. swiftwater (Payload) vs pl_swiftwater vs vs pl_swiftwater (UGC) vs pl_swiftwater_ugc_final), but check that your work has not already been done.
+
: ''<small>They're easy to use and our readers find them far more pleasant to look at.</small>''
# Is the page just a definition of a term or concept? If so, it probably belongs in the '''[[Glossary]]'''.
+
 
 +
== Starting a New Page ==
 +
 
 +
* '''Make sure it's a topic that needs its own page''':
 +
# Does the page already exist?  Does it exist under a different name?
 +
# Is the page just a definition of a term or concept? If so, it may belongs in the [[Glossary]].
 
# Is it a topic already covered as a subtopic of another article?  If so, make a new page only if it is an advanced topic that can be heavily elaborated on (and don't forget to add a link from that page).
 
# Is it a topic already covered as a subtopic of another article?  If so, make a new page only if it is an advanced topic that can be heavily elaborated on (and don't forget to add a link from that page).
# Is it a very broad topic (like "Competitive Team Fortress 2" or "Combat Classes")?  Maybe it should be split into smaller topics.
+
# Is it a very broad topic (like “Competitive Team Fortress 2” or “Combat Classes”)?  Maybe it should be split into smaller topics.
* Design a layout for the page that gives all related information in a clean format.  
+
<br />
* <span style="color:#FF0000">'''Use templates for pages when available'''</span>
+
 
* When you are satisfied with what is hopefully at least an introductory amount of information in your article, link to it from related pages in their "See Also" sections so we can see it!
+
* Once ready and certain for the page, you may create the page by clicking on a red link to that page, or typing in the desired title of the page you want to create, and then clicking the red link.
* Categorize and always tag pages accordingly, remember to keep [[Special:Categories|Categories]] consistent across all pages and the whole wiki. You can check how categories work on wikis [http://www.mediawiki.org/wiki/Help:Categories Here!]
+
** Design a layout for the page that gives all related information in a clean format, refer to a recent page of similar topic or use a template.  
* Always add maintenance templates to pages accordingly - [[:Category:Maintenance_templates|'''Use the Templates!''']]
+
** When you are satisfied with what is hopefully at least an introductory amount of information in your article, link to it from related pages in their “See Also” sections so we can see it!
 +
** Categorize and always tag pages accordingly, remember to keep [[Special:Categories|Categories]] consistent across all pages and the whole wiki. You can check how categories work on wikis [http://www.mediawiki.org/wiki/Help:Categories Here!]
 +
** Add maintenance Templates to pages accordingly - [[:Category:Maintenance_templates|'''Use the Templates!''']]
 +
 
 +
 
 +
== Templates ==
 +
Templates help make pages look clean and user-friendly and you should learn how to use them and use them whenever you can. To learn how Templates work, click [http://meta.wikimedia.org/wiki/Help:A_quick_guide_to_templates here] or [http://meta.wikimedia.org/wiki/Help:Template here]. If still stuck, ask one of our staff members.
 +
 
 +
Our most updated list of templates can be consulted '''[[:Category:Template|here]]'''.
 +
 
 +
===Popular Templates===
 +
 
 +
====Map Pages Templates====
 +
* [[Template:NewInfobox Map|Map Infobox]]
 +
* [[Template:Map locations|Map Locations]]
 +
* [[Template:Maps navbox|Maps Navbox]]
 +
 
 +
====Player Pages Templates====
 +
* [[Template:NewInfobox Player|Player Infobox]]
 +
 
 +
====Team Pages Templates====
 +
* [[Template:NewInfobox Team|Team Infobox]]
 +
* [[Template:6sTeamCard|6sTeamCard]] - For dynamic 6v6 Team Cards
 +
* [[Template:6s team roster collapsible|6v6 roster]] - For basic 6v6 rosters
 +
* [[Template:HL_team_roster|Static HL Roster]] & [[Template:HL team roster collapsible|Collapsible HL Roster]] - For basic HL rosters
 +
 
 +
====League / Season Pages Templates====
 +
* [[Template:League infobox|League Infobox]]
 +
* [[Template:6s team roster|6v6 Team Roster Table]]
 +
* [[Template:ETF2L competitions|ETF2L Competitions Navbox]]
 +
* [[Template:Season infobox|Season Infobox]]
 +
 
 +
====Steam Group Pages Templates====
 +
* [[Template:Infobox Group|Steam Group Infobox]]
 +
 
 +
====Class page Templates====
 +
* [[Template:Class Weapon Table Row|Class Weapon Table Row]]
 +
* [[Template:Class Weapon Table Header|Class Weapon Table Header]]
 +
* [[Template:Class Weapon Table End|Class Weapon Table End]]
 +
 
 +
====Social/Community templates====
 +
* [[Image:TeamfortressTV icon.png|link=Template:TFTV_Thread]] [[Template:TFTV_Thread|TFTV Thread]]
 +
* [[Image:Youtube_icon.png|link=Template:YouTube]] [[Template:YouTube|Youtube Channel]]
 +
* [[Image:Youtube_icon.png|link=Template:YouTube_video]] [[Template:YouTube_video|YouTube Video]]
 +
* [[Image:Twitch_icon.png|link=Template:Twitch]] [[Template:Twitch|Twitch Channel]]
 +
* [[Image:Steam_icon.png|link=Template:Steam]] [[Template:Steam|Steam Profile]]
 +
* [[Image:Steam_icon.png|link=Template:SteamGuide]] [[Template:SteamGuide|Steam Community Guides]]
 +
* [https://www.mediawiki.org/wiki/Extension:EmbedVideo#Usage Embed Video]
 +
 
 +
====Match Templates====
 +
* [[Template:MatchList|Match List]] - ''Simplistic and effective way of showing scores''
 +
* [[Template:Logs.tf|Logs.tf link]] - ''Basic logs.tf link''
 +
* [[Template:GroupTableStart|GroupTableStart]] / [[Template:GroupTableSlot|GroupTableSlot]] / [[Template:GroupTableSlot|GroupTableSlot]] ''Basic table scorings''
 +
* [[Template:ETF2LGroupTableStart|ETF2LGroupTableStart]] / [[Template:ETF2LGroupTableSlot|ETF2LGroupTableSlot]] / [[Template:ETF2LGroupTableSlot|ETF2LGroupTableSlot]] - ''ETF2L style tables''
 +
* [[:Category:Brackets]] - ''All our brackets. Some are dynamic.''
 +
 
 +
====Others====
 +
* [[Template:Navbox|Blank Navbox]]
 +
* [[Template:Popular topics navbox|Popular Topics Navbox]]
 +
* [[Template:Weekmaps|This week maps Table]]
 +
* [[Template:Flag|Flag Icon]]
 +
* [[:Category:Maintenance templates|Maintenance Templates]]
 +
 
 +
 
 +
'''Tip:''' ''To see a template in action, go to the template page and then click "What links here", on the sidebar. This should take you to a page with links to where the template has been used.''
 +
 
 +
You are free to create your own Templates when necessary, but be sure to maintain consistency in colors and format across the wiki and write guidelines for the template usage in the template page. An example of a well elaborated template can be seen [[Template:Player infobox|here]], notice the usage guidelines and the ready to copy template as well as an example given.
 +
 
 +
== Embedding Videos ==
 +
* Videos can be embedded on the wiki via a media wiki extension, you can check it's usage instructions [http://www.mediawiki.org/wiki/Extension:EmbedVideo#Usage here].

Latest revision as of 08:44, 13 October 2016


These are the Editing Guidelines for those wishing to contribute to the wiki. Please read them before editing pages.

Guidelines[edit]

  • All articles are to be writen in third person. No "I, you, me, us, we". etc.
If it helps, write as if you are teaching someone how the game is played, not how to play it. Example: “Engineers often do so-and-so”, instead of “As an Engineer, you should do so-and-so.”
  • There are more scenes out there than just the one you are on about. Include things that may be different across scenes. (eg: Map list, Map rules, Weapon list, etc...)
  • Avoid opinions and unsupported generalizations.
If people disagree with you, it is not something that belongs in a wiki (unless you present it as an opinion, ie. “It is believed by some soldiers that the Black Box is useful for roaming” versus “I like the Black Box, it's great for roamers. Try it out!”).
  • There are always going to be controversial topics like strategies, loadout choices, weapon and offclass choices etc., but because we are a competitive wiki, we aim to help new players as much as possible, so guides and guidelines for classes / strategies can be added even if they are controversial, in a constantly changing game like ours would be almost impossible to set in stone that this or that strategy is 100% sure and not biased. Just make sure to create new sections or appropriate pages with common sense. For example, a very specific spy guide, writed by a specific player, won't obviously be unbiased and 100% right, but it is still a great potential resource for new players if added and tagged accordingly as so.
  • Use the discussion tabs on each page to discuss possible changes / updates or suggestions to those pages.
  • Summarise your edits.
This is for easier revision and moderating purposes.
  • Add references if you can, and if applicable.
  • Try to group multiple edits of the same page into a single edit. We encourage using the "Show Preview" button and proof reading.
This is for easier revision and moderating purposes. Sometimes things slip though, so don't worry if you have that one off.
  • Categorise your page/templates/images and keep them consistent across the board.
If you're unsure of what Category to use, look at other examples of the same thing, ask our staff or simply make a reasonable one yourself.
  • Use Templates for pages when available.
They're easy to use and our readers find them far more pleasant to look at.

Starting a New Page[edit]

  • Make sure it's a topic that needs its own page:
  1. Does the page already exist? Does it exist under a different name?
  2. Is the page just a definition of a term or concept? If so, it may belongs in the Glossary.
  3. Is it a topic already covered as a subtopic of another article? If so, make a new page only if it is an advanced topic that can be heavily elaborated on (and don't forget to add a link from that page).
  4. Is it a very broad topic (like “Competitive Team Fortress 2” or “Combat Classes”)? Maybe it should be split into smaller topics.


  • Once ready and certain for the page, you may create the page by clicking on a red link to that page, or typing in the desired title of the page you want to create, and then clicking the red link.
    • Design a layout for the page that gives all related information in a clean format, refer to a recent page of similar topic or use a template.
    • When you are satisfied with what is hopefully at least an introductory amount of information in your article, link to it from related pages in their “See Also” sections so we can see it!
    • Categorize and always tag pages accordingly, remember to keep Categories consistent across all pages and the whole wiki. You can check how categories work on wikis Here!
    • Add maintenance Templates to pages accordingly - Use the Templates!


Templates[edit]

Templates help make pages look clean and user-friendly and you should learn how to use them and use them whenever you can. To learn how Templates work, click here or here. If still stuck, ask one of our staff members.

Our most updated list of templates can be consulted here.

Popular Templates[edit]

Map Pages Templates[edit]

Player Pages Templates[edit]

Team Pages Templates[edit]

League / Season Pages Templates[edit]

Steam Group Pages Templates[edit]

Class page Templates[edit]

Social/Community templates[edit]

Match Templates[edit]

Others[edit]


Tip: To see a template in action, go to the template page and then click "What links here", on the sidebar. This should take you to a page with links to where the template has been used.

You are free to create your own Templates when necessary, but be sure to maintain consistency in colors and format across the wiki and write guidelines for the template usage in the template page. An example of a well elaborated template can be seen here, notice the usage guidelines and the ready to copy template as well as an example given.

Embedding Videos[edit]

  • Videos can be embedded on the wiki via a media wiki extension, you can check it's usage instructions here.