Help:Naming conventions
From SABR Encyclopedia
This version of the naming convention guidelines for the Encyclopedia is largely gathered from existing practice. It should provide enough information to create new names consistently without having to examine names of current items.
This document should always reflect current practice, so if you are going to name something, it is important that you either follow these guidelines or update this page.
Contents |
Pages
People
Main article: Help:Naming conventions (people)
Pages for people should be named with the "use name" of the person. Use names generally consist of a given name followed by a family name, and frequently do not correspond with full, legal names. Manny Ramirez is a use name (and proper page name). Manuel Aristides Ramírez Onelcida is Manny's legal name, and differs in the inclusion of a middle name, matrilineal name, and the correct form of the letter 'í' in the patrilineal surname.
When two players have the same use name, their page names must be disambiguated. If there is a clearly most significant player (frequently, one major leaguer in a field of minor leaguers), that player's page should use the use name, and all others should be extended, with a disambiguation page at Use Name (disambiguation). If no player stands out, all should be extended, and the use name should redirect to a dedicated disambiguation page. (More guidance is needed here on best practices for extending page names - should this be primarily based on birthdate, or career?)
When two players with the same use name are automatically added to the encyclopedia, their pages are extended with the players' SABR Player IDs in parentheses.
Teams
Team-season pages are currently named with the year, location, and league. The location is the one used to describe the team, and not necessarily a precise, or even accurate, description of where the team plays. For example, 2009 River City (Frontier) is the current name for the River City Rascals, who played in O'Fallon, Missouri. "River City" is an appellation used to signify the team's location in greater St. Louis, and does not correspond to any actual place name.
Team-season page names are planned to change to incorporate team nicknames in October 2009.
There is not yet a formal convention for "franchise" page names.
Ballparks
Main article: Help:Ballparks#Page naming and disambiguation
Ballparks pages are generally named for the full name of the ballpark. In the case of multiple parks sharing a name, they are disambiguated by adding the city (actual city, not team locale appellation) in parentheses. In the case of multiple parks in one city, they are differentiated using roman numerals. There are examples of both forms of disambiguation in the League Park disambiguation page.
Places
Places within the United States are generally named for their place name and state name. Cleveland, Ohio is one example. Places outside the United States should add the standard short for English name for the country (as defined in ISO 3166-1).
The standard for whether a place should have a page or be grouped with a nearby city is still evolving.
Colleges
College pages should be named according to the "School Name" column in Help:College names. US colleges should be disambiguated by adding the state name in parentheses. International colleges should be disambiguated with the ISO 3166-1 short country name. In all cases where two colleges share a name, the name itself should be a disambiguation page. For example:
- Saint Mary's University - disambiguation page
- Saint Mary's University (TX) - University in San Antonio
- Saint Mary's University (Canada) - University in Halifax
- Saint Mary's University of Minnesota - This title does not require disambiguation, since the official school name includes the state.
In the case of this example, the disambiguation policy is entirely hypothetical, since none of these universities have a page in the encyclopedia.
Other pages
There are currently no standards for naming of pages that fall outside of these categories. If you create such a page, please document it here.
Templates
System templates
Templates are named in all lowercase, except for the first letter, with dashes between the words. The first word of a template's name is usually its scope - this generally specifies what sort of page will be transcluding the template. Template:Person-page and Template:Person-infobox are both transcluded by people pages. Template:Sabrlinks-journals is transcluded by "/sabrlinks" subpages.
League navbox templates
League navbox templates are named for the full name of the league, followed by the word navbox. For example, Template:2009 American League navbox.
Variables and properties
Template variables
Template variables use lower camel case - e.g. nameFirst.
Semantic properties
Semantic properties have words separated by dashes, with the first word capitalized. For example, Person-name-first.
CSS
Classes
Classes are named in all lowercase, with words separated with dashes.
IDs
IDs are named in all lowercase, with words separated with dashes.
