Help:Editing People Pages

From SABR Encyclopedia

Revision as of 20:27, 9 July 2009 by GarverP01 (Talk | contribs)
Jump to: navigation, search

This page is a step-by-step guide to editing pages describing the careers of people. It covers most of the common scenarios that arise while doing biographical research.

Contents

What do to if you're not sure

Pages in the Encyclopedia should contain information which is factually accurate and, to the extent possible, sourced by reliable primary and secondary citations. Even without a citation handy, you will encounter pages on which there appears to be some sort of factual conflict, for instance, a person listed as playing in a season after he is listed as dying, or a World War I veteran listed as killed in action with a date of death in the 1950s. When you see such a situation, but you don't have a source which allows you to determine which information is correct and which is erroneous to resolve a conflict, do not simply guess and delete the information you believe is inaccurate. Instead, tag the page (at the top) with the possible-error-flag template. This will place a box at the top of the page indicating a factual conflict has been identified. Then, use the discussion page for that person (click the box labeled "discussion" at the top of the page) to describe the conflict, and give any partial information you might know about its potential resolution.

In editing a person's career, do not delete records from his list of engagements unless that engagement is entirely in error. If you simply suspect that the engagement has been attached to the wrong person, use the possible-error-flag mechanism. Deleting the engagement does not fix the problem, and, in fact, makes the error more obscure. If you find, for instance, a playing record listed with a John Smith after he died, and simply delete it, we lose the information that there was a player, probably named Smith, possibly named John, who played on that team. While keeping that playing record on John Smith's page creates a logical absurdity, it also flags that for others to identify the correct solution; deleting it increases the likelihood the error will perpetuate itself even longer.

Guidelines for pages on Major Leaguers

With a small number of exceptions, the identification of playing, managing, and umpiring records for Major Leaguers are well-established. For this set of people, the infobox on the person's page includes their Retrosheet ID. Major League engagement records are synchronized against the authoritative sources for this information. Therefore, Major League engagement records should not be transferred from one page to another. If a minor league or other record is incorrectly assigned to a Major League person, move the other, non-Major League records from the person's page, creating a new person page if necessary or appropriate. Moving Major League engagement records without also moving the Retrosheet ID will lead to a conflict, and the change will get undone at the next synchronization, so the changes you intended to make will be overwritten.

Identifying a new person not in the Encyclopedia

Each person who is notable should have, at a minimum, a main page describing their career. If you identify someone meeting the notability criteria, first make sure the person is not in the Encyclopedia under a different name or a variation of the name. If he (or she) has no page, then you should create a new one.

Create a new page by typing the page name you want to create in the "search" box. Be sure to review the naming conventions for pages pertaining to people. Generally, pages are named Firstname Lastname, where the "Firstname" is the name most commonly used to refer to or address the person. (This is referred to in many places as his "common name" or, in our case, his "encyclopedia name.") If there is already a page with that name, you will need to determine a way to disambiguate your new person from the existing person (or people) with the same name. The naming conventions page has links to procedures for doing that. If your search on that name fails, you'll get a message indicating the page does not exist, and offering you a link (in red) to create the page. Click on that link, and you'll get a blank edit box to create the page.

A good way to create your first page is to imitate an existing page. However, at a minimum, a page should have at least the following elements.


{{person-infobox
 | nameLast= Shlabotnik
 | nameFirst= Joe
 | nameGiven= Joseph Tadeusz
}}

'''Joe Shlabotnik''' was a professional batboy for the Bad News Bears from 1947 to 1962.

{{person-career-start}}
{{person-career-end}}

{{person-narrative-stub}}
{{person-statistics-stub}}
{{person-sabr-links-stub}}
{{person-external-links-stub}}

[[Category:People|Shlabotnik, Joe]]

The person-infobox contains basic biographical information about a person. This template flags a page as being the "primary" page about a person. There is a program that periodically extracts and indexes this information, so it is important to include this. It also creates the nice person summary box on the right side of the page. See the documentation for this template for the other fields that are available. You can simply omit any fields you don't have information about. There are fields for IDs in various ID systems. In the event your person has an ID in some ID system that's covered, include it. This is unlikely, as every person with an ID in these systems should already have a page, but there is always a chance one may be missed. Do not create IDs, however; it is completely fine to leave these blank.

Every page should contain at least a brief one-sentence description of why the person is notable. More is better, but for many people very little may be known.

The person-career-start and person-career-end templates delineate a section of the page which formally lists the capacities in which the person was involved in baseball. See the documentation on SABR Encyclopedia:People for the possible entries which can go in this section.

The next four lines are placeholders for future development; please put them in all the pages for now.

Finally, each person should be placed in the People category, which is what the last line does. The text after the vertical bar | controls where the page will be listed in sort order. Doing this will make Shlabotnik's page show up in the S's, where most people would expect to find it, instead of the J's (for Joe). Consider whether your person might also fit in some other category; common ones include Veterans, for anyone who served in the active duty armed forces of any country.


Identifying a new person currently listed only by last name

In the case of a person known only by his last name, the Encyclopedia uses the name "Unknown" (see for example Unknown Williams). If you identify the first name of a person, there are three possibilities:

  1. The person already exists in the Encyclopedia. In that case, follow the rules below for transferring engagement records between people. If all the records assigned on the unknown's page belong to the person you've identified, you should delete the unknown's page completely after transferring the records.
  2. The person does not exist in the Encyclopedia, but only some of the records on the unknown's page belong to the newly identified person. In this case, create a new page for the new person using the above procedure, and add in the engagement records belonging to him in his career section. Edit the unknown's page to delete those engagement records.
  3. The person does not exist in the Encyclopedia, and all of the records on the unknown's page belong to the newly identified person. In this case, treat it as a name change, and follow the instructions below. In this case, please also clear out the milbID field in the person-infobox. In the Minor Leagues Database, the IDs ending in three dashes are reserved for unidentified people. Removing this ID from the page will trigger the issuance of a new ID for the person under his correct name.


Changing a person's encyclopedia name

When you update a person's encyclopedia page and change the nameFirst entry in his infobox, you should make several related changes. Check the narrative text to make sure any references to the previous name are revised to the new name, where appropriate. Check the list of categories at the bottom of the page, and update the first name in the category entries as appropriate. Finally -- and importantly -- you will need to move the person's page to reflect the name update. After saving your edits, click the "Move" tab at the top of the page, and give the person's new name as the new page name. Make a note to the effect that you're updating the page title based on new information about the person.

Before you move, check to see what other pages link to this page. Some links, such as links in rosters and statistical tables, are automatically generated, and will be updated in a few days automatically to reflect your page move. Some other links may be in human-edited narrative text or other parts of the page. Consider editing those pages to point to the new page name. The software automatically creates "redirects" whenever you move a page, so the page is still accessible from the old name. However, it is a good habit to make sure pages don't unnecessarily link through redirects, as this can have some unintended consequences down the line. To take the example above, suppose we find out Joe Shlabotnik actually went by "Tad" instead of "Joe." We would then edit his page accordingly, then move his page to "Tad Shlabotnik." When we do this, an automatic redirect from "Joe Shlabotnik" to "Tad Shlabotnik" would be created, so any page pointing to "Joe Shlabotnik" would actually take the reader automatically to "Tad Shlabotnik." Now suppose further that someone else, perhaps his son, also warrants a page, and this person is known as "Joe." An editor might then create a new page for the new person at "Joe Shlabotnik." Now, if there are any pages referring to Tad that were still linking to "Joe Shlabotnik" they would now be pointing at the wrong Joe Shlabotnik.

The move operation will issue a warning if you attempt to move the page to a name that already exists. If this happens, you'll need to do some disambiguation work; see the naming conventions page for guidelines.


Transferring engagement records between people

We often find out that playing or other service records are assigned to the wrong person. Fixing this is easy, especially compared to some of the more complicated situations on this page. Simply edit the career segment of the person who's incorrectly credited with the records and remove those records, and then edit the career segment of the correct person to add those records in, and save both pages. That's all there is to it. If this change affects minor league playing or managing records, the change will automatically be propagated to the Minor Leagues Database, and statistics will be transferred; there's an automated program to harvest this information, so you don't need to take any further action to flag the change.

When you do this, this might affect the first and last active dates for the person, so check whether any of the body text of the article needs to be revised to reflect this.

Personal tools