User:Lembley/guide

This Manual of Style (MOS) or style guide is a set of standards for all FamilySearch wiki articles. It describes the visual and technical aspects of the wiki, including prose style, article structure, grammar, punctuation, and spelling that are unique to this wiki.

General Principles
Relevance - Articles and links must be relevant to the purposes of the FamilySearch research wiki. Content and images must be appropriate to the FamilySearch Research Wiki. Inappropriate content or links will be removed.

Accuracy - To give readers confidence in the accuracy of information in an article, contributors should cite the source of their information.

Usability - Information provided in the FamilySearch research wiki should be useful, usable information. Articles should direct readers to the most accessible resources, and explain instances where a less-accessible resource is more valuable. Priority should be placed on circulating over non-cirulating materials, and digitial over print versions of nearly identical resources.

Collaboration - The FamilySearch wiki is a collaborative effort. Content contributed to the wiki is relinquished to the community under the Creative Commons license. Individuals and organizations work together respectfully to create content that presents the best available information from a neutral point of view. Bylines are not appropriate. Explain terms and acronyms; avoid using local jargon. Become familiar with and abide by basic wiki etiquette.

Grammar and Punctuation
For assistance with general grammar, punctuation, capitalization or other writing mechanics questions, refer to these or other accepted authority:


 * Elements of Style (William Strunk)
 * Merriam-Webster Dictionary
 * A Manual for Writers of Research Papers, Theses, and Dissertations (Kate Turabian)
 * Chicago Manual of Style

For grammar, punctuation, capitalization and other writing details unique to genealogy or the FamilySearch wiki, see Writer's Guide for the FamilySearch Wiki.

Name a new article
Before creating a new article, take the time to think of a name that clearly explains in a few words the content of the article.


 * Unique titles. No two articles may have the same title.
 * A wiki search should be done for the proposed title to ensure that there is not an existing article with that title.
 * Avoid duplication of articles. If an article already exists for the same topic, contributors should edit the existing article rather than create a new article.
 * Specific but short titles. Titles should be as short as possible but specific enough that users can identify the topic of the article when it appears in the search results. Avoid clever but unclear titles. Remove any unnecessary words or punctuation.
 * Common terms. Titles should use common terms that users might search for. A well formatted name for a new article can be very helpful to users and make it easier for search engines to guide users to the most relevant wiki article.
 * You may want to run it by experienced wiki contributors.

Capitalization in article titles
In titles, use sentence-style capitalization, which means that only the first word and proper nouns are capitalized. (For some wiki capabilities, sentence capitalization is required.) Do not list words all in capitals unless the word is an acronym.


 * Exception: The historical records collections in FamilySearch.org use book title capitalization.


 * Correct: Cemetery records for St. Joseph County, Michigan


 * Correct: Finding newspaper records


 * Incorrect: Finding Newspaper Records


 * Correct: Franklin County, Illinois Court House


 * Correct: Using GEDCOM files to share family history


 * Incorrect: FAMILY HISTORY CENTERS


 * Correct: Canada Ontario Births (FamilySearch Historical Records)

Although the above rules apply when creating an article title, other rules apply when citing sources. See FamilySearch Wiki:Source Citation Format.

Place names
Places listed in ascending order. If a city or county is listed in a title, at least the state, province, or country where the place is located should also be listed. The place is listed in ascending order (smallest place to largest). Unlike most genealogy software place name conventions, Include the word "county" in the title of an article about a particular county.


 * Exception: The titles of historical records collections in FamilySearch.org list places in descending order.


 * Correct: Utah Salt Lake County Death Registers (FamilySearch Historical Records)


 * Correct: Canada Ontario Births (FamilySearch Historical Records)

Places that have had different names or jurisdictions. If a place has had more than one name or been in more than one jurisdiction (county, state, province, country and so on), the current name and jurisdiction should be used in the title. If the article gives information about the place only when it had a specific name or jurisdiction, use those in the title. Redirects can be used to make sure users will find the article regardless of the name or jurisdiction they search for.

Non English place names. Generally, if a country is listed in the title, use the English name (for example, Germany rather than Deutschland). Search engines pull up a different list of articles depending on the place that is listed in the title. Redirects can be used to make sure users will find the article regardless of which spelling is used.

Places and dates in titles. If the place, country, or time period is important to the content of the article, include them in the title of the article. Add the word county in the title if the article is about a county.


 * Correct: Birth records for Farmington, Utah, from 1890 to 1925


 * Correct: Orange County, California


 * Incorrect: Orange, California

Diacritics and quotation marks
In article titles, you may use words with diacritics or letters that do not appear in the English alphabet however, the search engine may not display the article if users search for the English version of the word. Quotation marks should be avoided in article titles.

Punctuation in the title
Do not end the title with punctuation.


 * Correct: Finding newspaper records


 * Incorrect: Finding newspaper records.

Abbreviations
Abbreviations, including US postal codes, should not be used in article titles or text because abbreviations can mean different things in different parts of the world. For example, the abbreviation CA could mean either California or Canada, depending on the reader's nationality.

For more information about naming conventions, see also Help:Naming conventions.

Italics
In a title, italicize only the titles of books and ships.

Rename an existing article
Renaming (moving) an article or page means giving it another name. In other words, the content on a page contained under one title is moved to a new page with a different title. The page is "renamed." Renaming an existing article may be desired if you find that the article title was misspelled or is ambiguous.

Naming subheadings within articles
Organizing information. In an article, subheadings or sections should be used to organize the content and keep similar information together. Subheadings should help users scan an article to find the information they need.

Guidelines for subheadings/section titles. Use the guidelines for article titles with the following differences.

Font
Regardless of the font you paste into the wiki edit screen, your work will be saved in the system's default font.

Bold
In rare cases, if a word must be emphasized, use bold.

Italics
Use italics if a word must be emphasized. List book titles in italics. Do not use italics for quoted text.

Underline
Because the use of underline indicates text with a hyperlink that can be clicked to learn more, do not use underline as a way to emphasize text. Do not underline book titles.

Geographical Names
A proposed style guideline Naming Conventions for Geographic Names is being discussed. Once a consensus is reached a guideline will be adopted.

Capitalization
Articles, buttons, or tabs. When referring to an article, button, or tab name, match the capitalization from the article title, button or tab.


 * Correct: If another style guideline is needed, list the issue on the Discussion page.


 * Incorrect: If another style guideline is needed, list the issue on the discussion page.

For the FamilySearch Research Wiki, use the following capitalizations and spellings.


 * family group record
 * family history center (This term is not trademarked and is not capitalized.)
 * Family History Library
 * FamilySearch
 * FamlySearch Research Wiki
 * FamilySearch website
 * FamilySearch.org or familysearch.org (Capitals make the site name easier to read, but both are correct.)
 * family tree
 * International Genealogical Index (IGI)
 * Personal Ancestral File (PAF)
 * GEDCOM
 * historical collections (in FamilySearch.org)
 * Internet
 * pedigree chart
 * record types (for example, census records, court records, military records)
 * The Church of Jesus Christ of Latter-day Saints ("The" is part of the official title and is capitalized.)
 * website
 * wiki (for example, the wiki, wiki articles, wiki pages, wiki community)

Places. Capitalize the word “city,” “county,” “state,” or “province” only when the word appears as part of a place name. Spelling variations of English. Variations of English are acceptable. For example, either colour (British) or color (United States) is acceptable. Each article should use only one variation of English. When editing, use the variation of English already established in the article.

Linking to other articles in FamilySearch wiki

 * FamilySearch Wiki:Linking
 * Help:Create an internal link
 * Help:Advanced Linking
 * Help:Section - the content under "Section linking" appears to be incorrect. A review is needed.
 * Help:Wiki markup

Linking through the use of page section templates

 * Dablink - the disambiguation template
 * Details
 * Further
 * Main
 * See also

Other possible templates to create include:


 * Subarticle - see Wikipedia's Template:Subarticle for details
 * Cat also - see Wikipedia's Template:Cat also for details

Linking through the use of metatemplates

 * See Category:Metatemplates for a list of metatemplates available for use

Linking to other Websites
See also: Create an external link

Links should not display the full URL
Many URLs (website addresses) are long and not reader-friendly. For readability's sake, links should not include the full URL of the destination page. There may be extremely rare instances where displaying the full URL is desirable, but this should be the exception, not the rule, and should be done only if there is a compelling reason.

Example 1: a link by itself
Correct: FamilySearch

Incorrect: www.familysearch.org/

Example 2: a link in context
Correct: Order United States military records online.

Incorrect: Go to https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&amp;SWEView=GPEA+Product+Detail+-+Features+View+FFO&amp;SWEHo=eservices.archives.gov&amp;SWETS=1199728061&amp;SWEPostnApplet=GPEA+Product+Form

https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&amp;SWEView=GPEA+Product+Detail+-+Features+View+FFO&amp;SWEHo=eservices.archives.gov&amp;SWETS=1199728061&amp;SWEPostnApplet=GPEA+Product+Form to order United States military records online.

Click here to order United States military records online.

Clearly, the first link is much easier to read, takes less space, and helps users understand what they will find by clicking the link.

"For pay" web sites
If you refer to a subscription website or one which has a charge to obtain information, use the "$" to indicate that there may be a fee for the site.

OCLC/WorldCat
Using the WorldCat template for these links will allow the links to be easily updated if the web address changes.

FHLC
Using the FHL template for these links will allow the links to be easily updated if the web address changes.

Record Search
Using the RecordSearch template for these links will allow the links to be easily updated if the web address changes.

Wikipedia
Using the Wikipedia template for these links will allow the links to be easily updated if the web address changes.

Preferred terms
The following terms are preferred.

website: should be one word and all lower case as recommended by The Chicago Manual of Style

FamilySearch.org or the FamilySearch website


 * (Do not refer to the website as FamilySearch. Legally, FamilySearch is the name of the organization responsible for FamilySearch.org and other family history projects.)


 * Correct: You can search historical record collections at FamilySearch.org.


 * Incorrect: You can search historical record collections at FamilySearch.

FamilySearch Research Wiki (just "wiki" or Research Wiki is also acceptable)


 * Correct: Creating a new article in the FamilySearch Research Wiki


 * Incorrect: Creating a new article in the FamilySearch wiki

Latin abbreviations. Do not use ca., etc., e.g., or viz. Use simple English instead.


 * ca. (Use "about")


 * e.g. (Use "for example.")


 * etc. (Use "and so on" or "and so forth.")


 * i.e. (This term actually means "that is," and is often used incorrectly to mean "for example." Depending on meaning, use "that is," "such as," or "for example.")


 * viz. (Use "namely.")

Box layout: columns vs. portals
Authors desiring to display a wiki page's content in boxes should use tables within columns instead of using sub-pages within portals. To see the code that allows one to layout columns and tables, go to the Maryland page, click Edit, and switch to Wikitext view. To see an example of portal code, go to the India portal on Wikipedia and click Edit this page. For more about this topic, see The Un-Portal Page.

Draft Pages or Sandboxes
Major editing work on a page that will not be finished for an extended time may confuse visitors to the page. To avoid this, it is recommend that lengthy or long term editing preparations are worked on in a sandbox you create. Be sure to add a link in the "Discussion" page of where the planned changes will be posted, to the sandbox where the planned changes are being worked on. This will allow comments on the new content until it is moved from the sandbox page to the page that needs the changes.

Measurements
Metric or U.S. If measurements are needed, they can be written in metric or U.S. systems. The same system should be used throughout the article. It is recommended that the contributor provide the measurement in both systems. Metric may be listed first with the U.S. equivalent in parentheses, or the U.S. measurement may be listed first with the metric equivalent in parentheses. The same order should be used throughout the article.


 * Correct: Many narrow-gauge railroads in the Maine forests were 2 ft (610 mm) wide.


 * Correct: Many narrow-gauge railroads in the Maine forests were 610 mm (2 ft) wide.

Including a unit. Always include the unit of measurement with the number (for example, yard, meter, quart, and so on). Standard abbreviations may be used if they do not have more than one meaning.


 * Correct: Staten Island in New York City covers 59 square miles (153 square kilometers).


 * Correct: Staten Island in New York City covers 59 sq mi (153 km2).


 * Incorrect: Staten Island in New York City covers 59m.

Currencies
Listing costs of services. When referring users to a site or institution that charges for its services, it is appropriate to let users know there will be a charge. However, because prices change often, it is best to avoid listing the exact cost of the services.


 * Correct: There is a fee to get a copy of a deceased ancestor’s Social Security application.


 * Incorrect: There is a US$27-$29 fee to get a copy of a deceased ancestor’s Social Security application.

Identifying the currency listed. If it is important to indicate an amount of money, indicate both the amount and which currency is listed (Canadian dollars, Japanese yen, Mexican pesos, British pounds, and so on). Frequently, an abbreviation for the country is listed in front of the amount (for example, US$25). The original price and the equivalent in today’s money may be listed.


 * Correct: In 1800, a private in the British infantry was paid 1 shilling a day.


 * Correct: For the Louisiana Territory, the United States paid France US$15,000,000.


 * Incorrect: For the Louisiana Territory, the United States paid France almost $190 million in today’s money.