Template:Listplayer/Current/doc

Overview
WHEN TO USE LISTPLAYER VS LISTPLAYER/CURRENT:


 * Current Roster --> Listplayer/Current with Listplayer/Current/Start and Listplayer/Current/End
 * Former Roster --> Listplayer with Listplayer/Start and Listplayer/End or with manual table starts and ends
 * Organization --> Listplayer or Listplayersp with Listplayer/Start and Listplayer/End or with manual table starts and ends
 * Inactive Roster --> Listplayer/Current/NoSMW with Listplayer/Start and Listplayer/End (syntax is the same as Listplayer/Current for easy copy-paste, but SMW properties will not be created).

Why is this distinction important?


 * A lot of stuff on the wiki is automated using something called "Semantic MediaWiki" which encodes information into a database that is queryable in other places. So if we encode the current roster on one page, we can then query it elsewhere and display the information that was encoded in a new format. So Listplayer/Current encodes the information that's put into it as the team's current roster. Listplayer and Listplayersp don't. We ONLY want current players' information encoded, so it's important to use the two separate templates exactly as described above.

Usage with starting and ending templates


 * You MUST use Listplayer/Current with Listplayer/Current/Start and Listplayer/Current/End. IF YOU DO NOT USE THESE SISTER TEMPLATES, YOUR CODE WILL NOT WORK!!! See above for templates to use with former and organization. If you use current templates in the wrong place, everything will break!!!

Updating Pages
If a page is currently using Listplayer for everything, please do all of the following:
 * Switch all current players to Listplayer/Current
 * Replace manual table start/ends with Listplayer/Current/Start and Listplayer/Current/End only in the current roster section
 * Add official Riot residency as the  argument (if unknown write
 * Change  to   (syntax updated for future simplicity)
 * Remove the  argument (this is no longer needed)
 * Ensure that no player uses the syntax of  and instead use the syntax
 * {|style="text-align:center"


 * Good || Bad
 * }
 * Optional but encouraged: update former players and organization sections manual table starts and ends to Listplayer/Start and Listplayer/End. If you use "current" outside of "current roster" you will break stuff so be careful!
 * Concurrently, or immediately after, update the appropriate Teams Portal page - updating the team page will break the current format for the team portal page. See PortalTeamDisplay for more information on its usage.
 * Optional but encouraged: update former players and organization sections manual table starts and ends to Listplayer/Start and Listplayer/End. If you use "current" outside of "current roster" you will break stuff so be careful!
 * Concurrently, or immediately after, update the appropriate Teams Portal page - updating the team page will break the current format for the team portal page. See PortalTeamDisplay for more information on its usage.

Example


Additional Notes
The Semantic MediaWiki used in Listplayer/Current and its sister templates will only within the Main namespace (i.e. pages that don't start with Template: or User: or Category: etc.) That means you don't have to worry about causing problems from using this template within your user namespace.

See Listplayer/Current/Start for more information about usage.