90,866
edits
FamilySearch Wiki:Manual of Style: Difference between revisions
m
fix cat
(Fix links) |
m (fix cat) |
||
| Line 1: | Line 1: | ||
A '''style guide''' or '''style manual''' is a set of standards for design and writing of documents, either for general use or for a specific publication or organization. Web site style guides focus on a publication's visual and technical aspects, prose style, best usage, grammar, punctuation, spelling, and fairness. The consistent use of style guidelines provides uniformity in style and formatting of wiki articles, which makes the articles easier for readers to understand and use. | A '''style guide''' or '''style manual''' is a set of standards for design and writing of documents, either for general use or for a specific publication or organization. Web site style guides focus on a publication's visual and technical aspects, prose style, best usage, grammar, punctuation, spelling, and fairness. The consistent use of style guidelines provides uniformity in style and formatting of wiki articles, which makes the articles easier for readers to understand and use. | ||
== General Principles == | == General Principles == | ||
| Line 7: | Line 7: | ||
=== Name a new article === | === Name a new article === | ||
{{main|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. Remove any unnecessary words or punctuation. You may want to run it by experienced wiki contributors. | {{main|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. Remove any unnecessary words or punctuation. You may want to run it by experienced wiki contributors. A correctly formated name for a new article can be very helpful to users. | ||
==== Place names | ==== Place names ==== | ||
Unlike most genealogy software place name conventions, Include the word "county" in the title of an article about a particular county. | Unlike most genealogy software place name conventions, Include the word "county" in the title of an article about a particular county. | ||
==== Abbreviations | ==== 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. | 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]]. | For more information about naming conventions, see also [[Help:Naming conventions]]. | ||
| Line 39: | Line 39: | ||
==== Capitalization ==== | ==== Capitalization ==== | ||
=== | === Source Citations === | ||
=== Geographical Names === | === Geographical Names === | ||
| Line 45: | Line 45: | ||
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. | 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 | === Acronyms and Abbreviations === | ||
== Linking == | == Linking == | ||
| Line 105: | Line 103: | ||
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|Maryland page]], click '''Edit''', and switch to Wikitext view. To see an example of portal code, go to the [http://en.wikipedia.org/wiki/Portal:India India portal on Wikipedia] and click '''Edit this page'''. For more about this topic, see [[FamilySearch Wiki:The Un-Portal Page |The Un-Portal Page]]. | 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|Maryland page]], click '''Edit''', and switch to Wikitext view. To see an example of portal code, go to the [http://en.wikipedia.org/wiki/Portal:India India portal on Wikipedia] and click '''Edit this page'''. For more about this topic, see [[FamilySearch Wiki:The Un-Portal Page |The Un-Portal Page]]. | ||
{{policies and guidelines}} | |||