FamilySearch Wiki:Headings for Articles about Records

From FamilySearch Wiki

(Difference between revisions)
(New page: Wiki contributors frequently ask "How should I write articles. What kinds of information should I include?" To help answer this, a committee of FamilySearch employees and volunteers used a...)
 
Line 1: Line 1:
Wiki contributors frequently ask "How should I write articles. What kinds of information should I include?" To help answer this, a committee of FamilySearch employees and volunteers used a series of meetings to compile a list of the headings used by various authors in wiki articles, in FamilySearch publications, and in Record Search at FamilySearch Labs. The following is a list of those headings. This list is not intended to restrict an author, but to prompt him to write the kinds of information that will be useful to a customer who wants to use a certain record. These headings are meant to be a help, not a restriction, so feel free to experiment in changing their order or wording, or by combining them when it makes sense. The first wiki article which implemented this list of headings was the Maryland Maps page. Studying this page will show you that some of the headings were combined, so feel free to experiment. We will learn best practices as we implement the list.
+
Wiki contributors frequently ask "How should I write articles. What kinds of information should I include?" To help answer this, a committee of FamilySearch employees and volunteers used a series of meetings to compile a list of the headings used by various authors in wiki articles, in FamilySearch publications, and in Record Search at FamilySearch Labs. The following is a list of those headings. This list is not intended to restrict an author, but to prompt him to write the kinds of information that will be useful to a customer who wants to use a certain record. These headings are meant to be a help, not a restriction, so feel free to experiment in changing their order or wording, or by combining them when it makes sense. The first wiki article which implemented this list of headings was the Maryland Maps page. Studying this page will show you that some of the headings were combined, so feel free to experiment. We will learn best practices as we implement the list.   
 
+
 
+
  
 
{| cellspacing="1" cellpadding="5" width="100%" border="1"
 
{| cellspacing="1" cellpadding="5" width="100%" border="1"
|+ Headings for Record Type Articles
+
|+  
 
|-
 
|-
| '''Heading'''
+
| '''Heading'''  
 
| '''Description'''
 
| '''Description'''
 
|-
 
|-
| Record coverage/introduction
+
| Record coverage/introduction  
 
| The record’s time periods, jurisdictions (places?), and population coverage. Aternate title: When and Where the Record Existed. Do we cover the dates when the record was most complete?
 
| The record’s time periods, jurisdictions (places?), and population coverage. Aternate title: When and Where the Record Existed. Do we cover the dates when the record was most complete?
 
|-
 
|-
| Why to use the record
+
| Why to use the record  
 
| The most common uses of this record. The sales pitch for using the record. This could be omitted and covered in the Record Content section or in a strategy article. But if the user comes to a record type article directly from Google, this section may be needed.
 
| The most common uses of this record. The sales pitch for using the record. This could be omitted and covered in the Record Content section or in a strategy article. But if the user comes to a record type article directly from Google, this section may be needed.
 
|-
 
|-
| Record content
+
| Record content  
 
| Lists the types of information the record may yield. An alternate title for this heading is What will I find.
 
| Lists the types of information the record may yield. An alternate title for this heading is What will I find.
 
|-
 
|-
| Before searching you must know
+
| Before searching you must know  
 
| The family information needed in order to be able to search the record. If you search an archive vs. a Website, the information in this section would be different. Access point matters.
 
| The family information needed in order to be able to search the record. If you search an archive vs. a Website, the information in this section would be different. Access point matters.
 
|-
 
|-
| What to search before using this record
+
| What to search before using this record  
 
| This heading, used in Darris’ article, appears to be an extension of “Before Searching You Must Know.”
 
| This heading, used in Darris’ article, appears to be an extension of “Before Searching You Must Know.”
 
|-
 
|-
| Where to get the record
+
| Where to get the record  
 
| This section points to a few of the best sources of this record, such as a specific Website, library, or archives. Sources are recommended with accessibility, cost, record quality, and record completeness in mind.
 
| This section points to a few of the best sources of this record, such as a specific Website, library, or archives. Sources are recommended with accessibility, cost, record quality, and record completeness in mind.
 
|-
 
|-
| How to search/use the record
+
| How to search/use the record  
 
| Once you have identified the jurisdiction and the record collection you need, this section gives instructions on how to locate your ancestor in the record.
 
| Once you have identified the jurisdiction and the record collection you need, this section gives instructions on how to locate your ancestor in the record.
 
|-
 
|-
| [An image of the record]
+
| [An image of the record]  
 
| A picture of the record to show the customer what it looks like and what information such records might contain.
 
| A picture of the record to show the customer what it looks like and what information such records might contain.
 
|-
 
|-
| Record reliability
+
| Record reliability  
 
| This section analyzes which pieces of information in the record tend to be reliable vs. unreliable. (For instance, birth information on a death record is usually less reliable than death information.)
 
| This section analyzes which pieces of information in the record tend to be reliable vs. unreliable. (For instance, birth information on a death record is usually less reliable than death information.)
 
|-
 
|-
| Tips
+
| Tips  
 
| This section can include what to do if your search fails; special circumstances surrounding the search of a minority, minor, or common name; links to articles on how to decipher old handwriting or abbreviations; a heads-up on patronymics; etc.
 
| This section can include what to do if your search fails; special circumstances surrounding the search of a minority, minor, or common name; links to articles on how to decipher old handwriting or abbreviations; a heads-up on patronymics; etc.
 
|-
 
|-
| Tips for beginners
+
| Tips for beginners  
 
| Recommendations to search variant spellings, search online sources first, or special techniques. It may be that these can be folded in with the main Tips section.
 
| Recommendations to search variant spellings, search online sources first, or special techniques. It may be that these can be folded in with the main Tips section.
 
|-
 
|-
| What to do next
+
| What to do next  
 
| This section can include a prompt to find other family members in this record -- or other records this record might lead to. See Darris Williams’ wiki article “Register of Cottage Leases Dowlais Iron Company 1818 to 1877” and Jennifer Kerns’ “Ohio Birth Records 1867 – December 19, 1908.”
 
| This section can include a prompt to find other family members in this record -- or other records this record might lead to. See Darris Williams’ wiki article “Register of Cottage Leases Dowlais Iron Company 1818 to 1877” and Jennifer Kerns’ “Ohio Birth Records 1867 – December 19, 1908.”
 
|-
 
|-
| Terms
+
| Terms  
 
| Common words used to describe the record or words commonly found in the record.
 
| Common words used to describe the record or words commonly found in the record.
 
|-
 
|-
| Important Dates
+
| Important Dates  
 
| Dates of significant changes to the records.
 
| Dates of significant changes to the records.
 
|-
 
|-
| See Also
+
| See Also  
 
| Links to related content.
 
| Links to related content.
 
|}
 
|}
  
 
 
 
 

Revision as of 20:56, 7 January 2009

Wiki contributors frequently ask "How should I write articles. What kinds of information should I include?" To help answer this, a committee of FamilySearch employees and volunteers used a series of meetings to compile a list of the headings used by various authors in wiki articles, in FamilySearch publications, and in Record Search at FamilySearch Labs. The following is a list of those headings. This list is not intended to restrict an author, but to prompt him to write the kinds of information that will be useful to a customer who wants to use a certain record. These headings are meant to be a help, not a restriction, so feel free to experiment in changing their order or wording, or by combining them when it makes sense. The first wiki article which implemented this list of headings was the Maryland Maps page. Studying this page will show you that some of the headings were combined, so feel free to experiment. We will learn best practices as we implement the list. 

Heading Description
Record coverage/introduction The record’s time periods, jurisdictions (places?), and population coverage. Aternate title: When and Where the Record Existed. Do we cover the dates when the record was most complete?
Why to use the record The most common uses of this record. The sales pitch for using the record. This could be omitted and covered in the Record Content section or in a strategy article. But if the user comes to a record type article directly from Google, this section may be needed.
Record content Lists the types of information the record may yield. An alternate title for this heading is What will I find.
Before searching you must know The family information needed in order to be able to search the record. If you search an archive vs. a Website, the information in this section would be different. Access point matters.
What to search before using this record This heading, used in Darris’ article, appears to be an extension of “Before Searching You Must Know.”
Where to get the record This section points to a few of the best sources of this record, such as a specific Website, library, or archives. Sources are recommended with accessibility, cost, record quality, and record completeness in mind.
How to search/use the record Once you have identified the jurisdiction and the record collection you need, this section gives instructions on how to locate your ancestor in the record.
[An image of the record] A picture of the record to show the customer what it looks like and what information such records might contain.
Record reliability This section analyzes which pieces of information in the record tend to be reliable vs. unreliable. (For instance, birth information on a death record is usually less reliable than death information.)
Tips This section can include what to do if your search fails; special circumstances surrounding the search of a minority, minor, or common name; links to articles on how to decipher old handwriting or abbreviations; a heads-up on patronymics; etc.
Tips for beginners Recommendations to search variant spellings, search online sources first, or special techniques. It may be that these can be folded in with the main Tips section.
What to do next This section can include a prompt to find other family members in this record -- or other records this record might lead to. See Darris Williams’ wiki article “Register of Cottage Leases Dowlais Iron Company 1818 to 1877” and Jennifer Kerns’ “Ohio Birth Records 1867 – December 19, 1908.”
Terms Common words used to describe the record or words commonly found in the record.
Important Dates Dates of significant changes to the records.
See Also Links to related content.