To request editing rights on the Wiki, click here.

Changes

Jump to navigation Jump to search

FamilySearch Wiki:Manual of Style

2 bytes removed, 16:31, 10 March 2016
no edit summary
[[Help:Wiki Help|Wiki Help]] [[Image:Gotoarrow.png]] [[Help:Resources and lists|Resources and lists]] [[Image:Gotoarrow.png]] Manual of Style [[Image:Book-copy-1-.jpg|right|130x117px|Book-copy-1-.jpg]]
<br> A '''wiki''' '''manual of style''' (or style guide) is a set of standards for the design and writing of wiki articles.&nbsp; The guide provides direction for visual and technical aspects as well as prose style, grammar, punctuation, spelling, and wiki etiquette. The consistent use of style guidelines provides uniformity in style and formatting of wiki articles , making them easier for readers to understand and utilize.
== General Principles ==
'''Respectful interactions:''' Comments and edits should be made with respect for other users and contributors. [[FamilySearch Wiki:Etiquette Guidelines]]
'''Alternate research techniques:''' The techniques that genealogists employ while working on their family histories are very individualized. Rather than editing and reediting an article to suit an individual method for finding alternate information or different techniques , these things may be suggested in an additional section such as: "Other ways to find the information.".
'''Appropriate content:''' Content and images must be [[FamilySearch Wiki:Purpose and Appropriate Topics|appropriate]] to the FamilySearch Research Wiki. Inappropriate content or links will be deleted.
'''Neutrality:''' Articles should be as [[FamilySearch Wiki:Neutral point of view|neutral]] as possible. Descriptions should state facts and avoid negative or positive judgements.&nbsp; Using phrases such as "settlers from western Europe" rather than "poor, uneducated peasants" presents factual information without negativity. Avoid hype and exaggeration .&nbsp;
'''Simplicity:''' Writing should be clear and simple. When a term is used that may be unfamiliar to readers (for example, "gazetteer"), it should be defined the first time it appears in the body of an article as in this sentence:&nbsp; "In some areas newspapers were called gazetteers." &nbsp; Avoid using specialized terms or acronyms when a common term is available. As much as possible, the information should be understandable by every reader, even when English is not the users user's first language.
== Bylines ==
Everyone can contribute to FamilySearch Wiki. [[FamilySearch Wiki:Ownership of articles|Pages are not owned]] by anyone exclusively. Since anyone can work on a page, the original author of a page may see their work expanded and changed by others. When a contributor adds to or edits a wiki page, they relinquish ownership of the content is relinquished to the community. This relinquishment of content to the community is stated not only in a [[FamilySearch Wiki:Policies|policy page]] but also in the editing screen everyone uses to add content. For these reasons, [http://dictionary.reference.com/browse/byline bylines] are not appropriate on wiki pages. If information is added to the wiki from a specific published work, it is appropriate to [[Help:How to add citations|cite that]] work in a footnote, but it is not appropriate to "retain ownership" of a page through use of a byline.
== Grammar and Style ==
'''Consistent grammar style within an article:''' Grammar styles may vary by location and preference. Whatever style is chosen by the original contributor should be consistently maintained throughout the article. Other contributors and editors should follow the original style.<br>
'''Complete sentences:''' Write with complete sentences (sentences that contain a subject and verb). Complete sentences are easier to understand, especially when English is not the readers reader's native language. The command form (which has an implied subject) is considered a complete sentence.
:;Correct
::{{xt|Parish records were kept from 1770 to 1932.}}
'''Shorter sentences that express one idea:&nbsp;''' As much as possible, write with shorter sentences that express one idea. They are easier to understand, especially when English is not a users user's native language.
:;Correct
::{{xt|This is an index to some birth and christening records from Arizona. The records cover 1909 through 1917. The index is not necessarily complete for any particular place or region.}}
'''Neutral tone:''' Writing should be factual and avoid stereotypes, judgments, and gender bias. However, quotes should not be changed to meet this guideline. If the quote has the potential to offend , find another quote.<br>
'''Avoid using “he or she":''' As much as possible, avoid using “he or she” and “his or hers” hers" (for example, “He or she can use the index to find his or her ancestor’s record quickly”). Do not use the plural pronoun “they” to replace “he or she.” Often, the problem can be solved by rewriting the sentence:
:;Correct
:;Exception
::<br>
::If the ampersand is part of an official name, use the ampersand.
*'''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 as they will be difficult to find using the search feature. Remove unnecessary words or punctuation.
*'''Common terms:''' Titles should use common terms that users might search for. A well chosen 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.
*'''Get input'''.&nbsp; : Consider consulting with an [[FamilySearch Wiki:Mentors|experienced wiki contributor]] if you have questions.<br>
==== Capitalization in article titles ====
:'''Exception:''' The historical records collections in FamilySearch.org use book title capitalization.<br>
{| width="625" cellspacing="1" cellpadding="1" border="1" width="625"
|-
| '''Correct'''<br>
==== 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" should be included 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.
{| width="625" cellspacing="1" cellpadding="1" border="1" width="625"
|-
| '''Correct'''<br>
|}
'''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. [[Help:Redirects|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.<br>
'''Non English place namesPlaces and dates in titles:''' GenerallyIf the place, if a country , or time period is listed important to the content of the article, include them in the title, use of the English name (for example, Germany rather than Deutschland)article. Search engines pull up a different list of articles depending on Add the place that is listed word "county" in the title. Redirects can be used to make sure users will find if the article regardless of which spelling is usedabout a county.<br>
'''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.<br>  {| width="625" cellspacing="1" cellpadding="1" border="1" width="625"
|-
| '''Correct'''<br>
==== '''Diacritics and quotation marks:''' <br> ====
In article titles, you may use words with diacritics (symbols used in other languages) or letters that do not appear in the English alphabet however. 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.<br>
==== Punctuation in the title: ====
Do not end the title with punctuation.
{| width="625" cellspacing="1" cellpadding="1" border="1" width="625"
|-
| '''Correct'''<br>
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.
<br>  ==== Guidelines for subheadings/section titles. ====
Use the guidelines for article titles with the following differences. Once you put in a title it can't be changed by you but subtitles can be changed, removed and reorganized by you.
*[[FamilySearch Wiki:WikiProject County Page Template]]
*[[FamilySearch Wiki:WikiProject U.S. counties|FamilySearch Wiki:WikiProject U.S. Counties]]
#Use Help pages they . They are guides to assist in the detailing of a page. An example:
*[[Help:Adding details to a Family History Center page]]
#Another guide that will help you organize a page is [[FamilySearch Wiki:Headings for Articles about Records|Headings for Articles about Records]]
#Then go to [[Help:Editing The Wiki|Editing The the Wiki]]. This page gives many ways to add to your page and options to use.
== Punctuation ==
::{{!xt|Bannow County Wexford}}
'''Punctuation in numbers.''' Use commas in numbers over 999 (for example, 1,000; , 1,000,000, and so on). Use a period to indicate a fraction of a digit (for example .25, 3.76, and so on).<br>
'''Punctuation within quotation marks.''' English-speaking areas follow differing guidelines for adding punctuation within quotation marks (for example, whether the period is placed within or outside of the final quotation mark). When editing, contributors should follow the existing style in the article.
|
Because the use of underline indicates text with a [http://www.webopedia.com/TERM/h/hyperlink.html hyperlink], do not use underline as a way to emphasize text.&nbsp; Do not underline book titles.<br>
|}
=== Geographical Names ===
A proposed style guideline ''[[FamilySearch Wiki:Naming Conventions for Geographic Names|Naming Conventions for Geographic Names]]'' is being [[FamilySearch Wiki talk:Naming Conventions for Geographic Names|discussed]]. Once a [[FamilySearch Wiki:Consensus|consensus]] is reached a guideline will be adopted.
=== Acronyms and Abbreviations ===
The first time you use a term that can be abbreviated, write it out and put the acronym in parentheses, e.g., the zone improvement plan (zip) codes were developed by the United States Postal Service (USPS) in 1963,.&nbsp;
== Capitalization ==
'''Merriam-Webster.''' When in doubt, follow Merriam-Webster.
'''Articles, buttons, or tabs.''' When referring to an article, button, or tab name, use the capitalization from the article title, button , or tab.
:;Correct
72
edits

Navigation menu