FamilySearch Wiki talk:Manual of StyleEdit This Page

From FamilySearch Wiki

(Difference between revisions)
(Moved discussion to FamilySearch Wiki:Linking to Directory Sites Whose External Links to Paid Sites are Ambiguous)
(Missing information in section 4.3: section needs completing)
 
(37 intermediate revisions by 12 users not shown)
Line 1: Line 1:
__TOC__  
+
{{talk header}} __TOC__  
 +
 
 +
This is the place for discussing stylistic details that affect many pages on the wiki. It covers mostly content changes that affect collections of wiki pages, whereas stylistic issues regarding the user interface, or general look and feel of the site, can be found [[FamilySearch Wiki:Site Design Ideas|elsewhere]]. 
 +
 
 +
This page covers two kinds of stylistic ideas: 
 +
 
 +
#Ideas that have reached a consensus among the FamilySearch Wiki community and can thus be executed over many pages. 
 +
#Ideas that have been proposed and need further discussion and consensus before implementation. (These ideas cannot be implemented over many pages until they have achieved a consensus decision.)
 +
 
 +
If you have an idea to add to the Manual of Style (MOS), see [[FamilySearch Wiki:Transforming a Style Idea to a Manual of Style Guideline|Transforming a Style Idea to a Manual of Style Guideline]], and then add your topic to Proposals being discussed section below.
 +
 
 +
== Issues that have reached a consensus decision  ==
 +
 
 +
*[[FamilySearch Wiki:Use History Heading Rather than Local Histories Heading in Place Pages|Use "History" Heading Rather than "Local Histories" in Place Pages]]
 +
*[[FamilySearch Wiki:Format for Citing and Linking to Works in FHLC, Worldcat (OCLC)|Format for Citing and Linking to Works in FHLC, Worldcat (OCLC)]]
  
 
== Proposals being discussed  ==
 
== Proposals being discussed  ==
  
 +
#Table of Contents: To Hide or Display by Default
 +
#[[FamilySearch Wiki:Separator for Items in See Also Section]]
 +
#[[FamilySearch Wiki:Buttons|Buttons]]
 +
#[[Access Codes|Access Codes]] (how to designate whether a linked site is free or fee-based)
 +
#[[FamilySearch Wiki talk:Breadcrumb Trails|Breadcrumb Trails]]
 +
#[[FamilySearch Wiki:Changing the Size of Font or the Color of Heading 1|Changing the Font Size and Color of Heading 1]]
 +
#[[FamilySearch Wiki:Adding References or Links to Books for Sale|Adding References or Links to Books for Sale]]
 
#[[FamilySearch Wiki talk:Consensus|FamilySearch Wiki Talk:Consensus]]  
 
#[[FamilySearch Wiki talk:Consensus|FamilySearch Wiki Talk:Consensus]]  
 
#[[FamilySearch Wiki talk:Source Citation Formats|FamilySearch Wiki Talk:Source Citation Formats]]  
 
#[[FamilySearch Wiki talk:Source Citation Formats|FamilySearch Wiki Talk:Source Citation Formats]]  
#[[FamilySearch Wiki:Linking to Works in the Family History Library Catalog|Linking to Works in the Family History Library Catalog]]
+
#[[FamilySearch Wiki talk:Format for Citing and Linking to Works in FHLC, Worldcat (OCLC)|Linking to works in the Family History Library Catalog (FHLC) and Worldcat (OCLC)]]  
#[[FamilySearch Wiki talk:Format for Citing and Linking to Works in FHLC, Worldcat (OCLC)|Linking to FHLC and Worldcat (OCLC)]]  
+
 
#[[FamilySearch Wiki:Naming Conventions for Geographic Names|Naming Conventions for Geographic Names]]  
 
#[[FamilySearch Wiki:Naming Conventions for Geographic Names|Naming Conventions for Geographic Names]]  
 
#[[FamilySearch Wiki:Disambiguation|Disambiguation]]  
 
#[[FamilySearch Wiki:Disambiguation|Disambiguation]]  
#[[FamilySearch Wiki:Interactive Maps and Lists of Sub-divisions|Interactive Maps and Lists of Sub-divisions]]
+
#[[FamilySearch Wiki:Interactive Maps and Lists of Sub-divisions|Interactive Maps and Lists of Sub-divisions]]  
 +
#[[FamilySearch Wiki:Linking to Directory Sites Whose External Links to Paid Sites are Ambiguous|Linking to Directory Sites Whose External Links to Paid Sites are Ambiguous]]
 +
#[[FamilySearch Wiki talk:Names, Personal vs Names Personal|"Names, Personal" versus "Names Personal"]]
 +
#"Language and Languages" versus "Languages"
 +
#[[FamilySearch Wiki:Localities Template to Replace Populated Places Section|Localities template to replace populated places section]]
 +
#[[FamilySearch Wiki:Infobox Template|Infobox template]]
 +
#[[Template talk:Wpd|Wpd (Wikipedia) template]]
 +
#[[FamilySearch Wiki:Linking|Linking]] 
 +
#[[FamilySearch Wiki:Spelling in the English-language Wiki|Spelling in the English-language wiki]]
 +
#[[FamilySearch Wiki:Naming a Project|Naming a project]]
 +
#[[FamilySearch Wiki talk:Web Sites versus websites|Web sites or websites]]
 +
#[[FamilySearch Wiki talk:Guidelines for FamilySearch Collections pages]]
 +
 
 +
== What to do with Help:Naming Conventions?  ==
 +
 
 +
[[Help:Naming conventions|Help:Naming conventions]] was created before we had the Manual of Style. It was also created "back in the day" when we discussed stylistic items in User Group meeting (Community Meeting) to reach consensus. Since Help:Naming Conventions deals with style more than instructions, I'm thinking it should be added to the FamilySearch Wiki namespace. I also wonder which (if any) of the conventions on Help:Naming Conventions deserves to be added to the Manual of Style or this discussion page. [[User:RitcheyMT|Ritcheymt]] 04:34, 8 June 2009 (UTC)
 +
 
 +
:I support the proposal to move [[Help:Naming conventions]] to the ''FamilySearch Wiki'' namespace. --[[User:Cottrells|Steve]] 09:25, 16 October 2009 (UTC)
 +
 
 +
:I also support the move and have added a discussion item to the page itself and also the "Move" template on the page. --Fran 18:20, 12 April 2010 (UTC)
  
 
== Guidelines for large projects  ==
 
== Guidelines for large projects  ==
  
It would be helpful to have some guidelines established for large projects, such as the pages created for US state or county pages. I'm thinking specifically of the England probate registers project that includes a page for each of the 40 counties. It's user-friendly to have the same "look and feel", including the heading and subheading styles. [[User:Anne|Anne]] 18:12, 27 April 2009 (UTC)
+
It would be helpful to have some guidelines established for large projects, such as the pages created for US state or county pages. I'm thinking specifically of the England probate registers project that includes a page for each of the 40 counties. It's user-friendly to have the same "look and feel", including the heading and subheading styles. [[User:WuehlerAC|Anne]] 18:12, 27 April 2009 (UTC)  
 +
 
 +
== A Place to Start  ==
 +
 
 +
I think it would be easiest to piggyback of what other wikis have done. People who begin contributing may already be used to these conventions. For example, the [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Wikipedia Manual of Style] gives some great ideas on what our conventions should be. Perhaps we lift from there and then change things as it becomes necessary to do so. --[[User:Gregorybean|Gregorybean]] 02:16, 20 October 2009 (UTC)
 +
 
 +
== Links  ==
 +
 
 +
What ever happened to format for the displayed text for links? If I remember correctly, "Click here to . . ." was considered an incorrect way to format them. I believe [[Help:Create an external link|Create an external link]] talks about this subject. [[User:Thomas Lerman|Thomas_Lerman]] 12:25, 21 June 2011 (UTC)
 +
 
 +
== Integration and links to other subjects  ==
 +
 
 +
I suggest that this page be linked to the general help and editing pages for the Wiki. I note that there is the navbox at the bottom of the page but I suggest that there be a link to an appropriate page at the top. Also I don't see that this page has ever been categorized.
 +
 
 +
[[User:Jamestanner|James L. Tanner]] 13:52, 5 January 2012 (UTC)
 +
 
 +
== Referencing Guidelines  ==
 +
 
 +
One of the major sections of all publishing manuals of style is how to reference specific types of information. This Manual of Style does not includie such guidance. Is this because of a conscious decision not to include these guidelines, or an unintentional oversight? Including this information standarizes the references, but more importantly, it gives greater assurance that the reference can be found, despite URL chages, and it gives credit to the creater of the information as well as the person or web site that is hosting the information.
 +
 
 +
[[User:Klk3|Klk3]] 20:48, 29 May 2012 (UTC)<br>
 +
 
 +
== Missing information in section 4.3 ==
 +
 
 +
The following catagory has missing information:
 +
 
 +
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.'''
  
 +
The following differences information (the sentence above in bold) &nbsp;is not listed in the article.
  
  
= Wiki - is it intended to be Mormon-oriented or is it intended to be all encompassing?  =
 
  
Objection had been posted concerning Baltimore, Maryland vs Baltimore (Independent City), Maryland.  
+
Also under the catagory: Linking through the use of page section templates, '''Other possible templates to create include:&nbsp;&nbsp;''' there are two red templates -either broken links or no content in those links.&nbsp; Need to fix links or add content.
  
Didn't we discuss the emphasis on reaching out to more places rather than emphasis on FHL Catalog? Many places do not recognize Baltimore (Independent City), Maryland. It is simply Baltimore, Maryland.
 
  
What's more Wikipedia mentions "Independent City" only in the article, same is true for the independent cities of Virginia as well as United Kingdom. The key is the simplicity of remembering the place names. Only in Family History Library Catalog you will find that term. [[User:Dsammy|dsammy]] 00:44, 31 May 2009 (UTC)
 
  
:I like simplicity. But sometimes simplicity all by itself isn't enough. Another important characterisitic is verifiable. Using a standard like "do it the way the FHL catalog does it" on place names gives us a standard that can be verified in most cases we would need, and predictable in the few cases that are not already in the catalog. If the only standard is simplicity by itself, that is harder to verify and predict what the concensus of users would agree is simple.
+
Thanks
  
:The logic behind the FHL Catalog standard should not be rejected just because it is associated with a "Mormon" organization. It is available to our Wiki community worldwide on the Internet and is specifically designed to help genealogists. Wikipedia has more of a general encyclopedia audience--it's standards, particularly on place names can be a useful guide, but the FHL Catalog has decades of thought and experience behind it and is more adapted to the needs of genealogists.
+
[[:Category:Featured Article Committee members|Featured Article Committee members]] –
  
:'''How do we title articles about towns?''' If our community reaches concensus that the FHL Catalog is a good standard to use for naming articles about places, I believe that would mean that&nbsp;articles about cities and towns like Chicago would carry the title '''''Chicago, Cook, Illinois''''', or '''''Fairfield, Jefferson, Iowa'''''. How does the community feel about this? If I understand what Dsammy is saying, he would prefer the more simple '''''Chicago, Illinois''''' or '''''Fairfield, Iowa'''''. What do our other contributors think? [[User:Diltsgd|Diltsgd]] 02:31, 31 May 2009 (UTC)
+
:It appears that this section was started and not finished by [[User:WilliamsDa|Darris]]. Looking back in the page history I found that this [https://www.familysearch.org/learn/wiki/en/index.php?title=FamilySearch_Wiki:Manual_of_Style&diff=prev&oldid=660838 section was added on 18 June 2011]. I have added a {{tl|ToDo}} template as a reminder that it is incomplete. --[[User:Cottrells|Steve]] {{toolbar|[[User talk:Cottrells|talk]]|[[Special:Contributions/Cottrells|contribs]]}} 16:35, 3 September 2012 (UTC)
::Take a look at [[Fairfield (disambiguation)|Fairfield (disambiguation)]]. It already distinguish several Fairfield's in one state. I am referring to usage of "independent city" in the url address.
+
::And this format is already widespread in several Wiki sites. If more than one is found in a specific area, just add the necessary identification like Fairfield, Hyde County, North Carolina and Fairfield, Union County, North Carolina. It's worse with Washington Townships so additional identification is necessary as needed and just for Iowa alone, there are 49 of them!)<br>What's more I can shoot down your assumption, in the Family History Library Catalog, you can't get "Chicago" with "Cook County", and instead of that it has to be either simply Chicago or Chicago with Illinois to get the search results. That is the logic behind the usage. The family historians are not going to type Fairfield, Jefferson, Iowa to get that because that part of information is already in the first line in the page in search results. Here's the result from search for "Fairfield, Utah" - Fairfield, Utah ... ed States]] &gt; [[Utah|Utah]] &gt; [[Utah County, Utah|Utah County]] &gt; Fairfield''... own in Utah County, Utah. For other uses, see [[Fairfield (disambiguation)|Fairfield (disambiguation)]]. '''' See how the info is presented instantly?<br>Secondly, why should it has to be to that way? You need to think OUTSIDE of the box to see how others see it. [[User:Dsammy|dsammy]] 03:57, 31 May 2009 (UTC)
+
::And I am going to have more fun with you. Check out [[Portland (disambiguation)|Portland (disambiguation)]]. And we are moving beyond what the FHL Catalog is into new areas not available at the FHL. [[User:Dsammy|dsammy]] 04:52, 31 May 2009 (UTC)
+

Latest revision as of 16:35, 3 September 2012

Contents


This is the place for discussing stylistic details that affect many pages on the wiki. It covers mostly content changes that affect collections of wiki pages, whereas stylistic issues regarding the user interface, or general look and feel of the site, can be found elsewhere

This page covers two kinds of stylistic ideas: 

  1. Ideas that have reached a consensus among the FamilySearch Wiki community and can thus be executed over many pages. 
  2. Ideas that have been proposed and need further discussion and consensus before implementation. (These ideas cannot be implemented over many pages until they have achieved a consensus decision.)

If you have an idea to add to the Manual of Style (MOS), see Transforming a Style Idea to a Manual of Style Guideline, and then add your topic to Proposals being discussed section below.

Issues that have reached a consensus decision

Proposals being discussed

  1. Table of Contents: To Hide or Display by Default
  2. FamilySearch Wiki:Separator for Items in See Also Section
  3. Buttons
  4. Access Codes (how to designate whether a linked site is free or fee-based)
  5. Breadcrumb Trails
  6. Changing the Font Size and Color of Heading 1
  7. Adding References or Links to Books for Sale
  8. FamilySearch Wiki Talk:Consensus
  9. FamilySearch Wiki Talk:Source Citation Formats
  10. Linking to works in the Family History Library Catalog (FHLC) and Worldcat (OCLC)
  11. Naming Conventions for Geographic Names
  12. Disambiguation
  13. Interactive Maps and Lists of Sub-divisions
  14. Linking to Directory Sites Whose External Links to Paid Sites are Ambiguous
  15. "Names, Personal" versus "Names Personal"
  16. "Language and Languages" versus "Languages"
  17. Localities template to replace populated places section
  18. Infobox template
  19. Wpd (Wikipedia) template
  20. Linking 
  21. Spelling in the English-language wiki
  22. Naming a project
  23. Web sites or websites
  24. FamilySearch Wiki talk:Guidelines for FamilySearch Collections pages

What to do with Help:Naming Conventions?

Help:Naming conventions was created before we had the Manual of Style. It was also created "back in the day" when we discussed stylistic items in User Group meeting (Community Meeting) to reach consensus. Since Help:Naming Conventions deals with style more than instructions, I'm thinking it should be added to the FamilySearch Wiki namespace. I also wonder which (if any) of the conventions on Help:Naming Conventions deserves to be added to the Manual of Style or this discussion page. Ritcheymt 04:34, 8 June 2009 (UTC)

I support the proposal to move Help:Naming conventions to the FamilySearch Wiki namespace. --Steve 09:25, 16 October 2009 (UTC)
I also support the move and have added a discussion item to the page itself and also the "Move" template on the page. --Fran 18:20, 12 April 2010 (UTC)

Guidelines for large projects

It would be helpful to have some guidelines established for large projects, such as the pages created for US state or county pages. I'm thinking specifically of the England probate registers project that includes a page for each of the 40 counties. It's user-friendly to have the same "look and feel", including the heading and subheading styles. Anne 18:12, 27 April 2009 (UTC)

A Place to Start

I think it would be easiest to piggyback of what other wikis have done. People who begin contributing may already be used to these conventions. For example, the Wikipedia Manual of Style gives some great ideas on what our conventions should be. Perhaps we lift from there and then change things as it becomes necessary to do so. --Gregorybean 02:16, 20 October 2009 (UTC)

Links

What ever happened to format for the displayed text for links? If I remember correctly, "Click here to . . ." was considered an incorrect way to format them. I believe Create an external link talks about this subject. Thomas_Lerman 12:25, 21 June 2011 (UTC)

Integration and links to other subjects

I suggest that this page be linked to the general help and editing pages for the Wiki. I note that there is the navbox at the bottom of the page but I suggest that there be a link to an appropriate page at the top. Also I don't see that this page has ever been categorized.

James L. Tanner 13:52, 5 January 2012 (UTC)

Referencing Guidelines

One of the major sections of all publishing manuals of style is how to reference specific types of information. This Manual of Style does not includie such guidance. Is this because of a conscious decision not to include these guidelines, or an unintentional oversight? Including this information standarizes the references, but more importantly, it gives greater assurance that the reference can be found, despite URL chages, and it gives credit to the creater of the information as well as the person or web site that is hosting the information.

Klk3 20:48, 29 May 2012 (UTC)

Missing information in section 4.3

The following catagory has missing information:

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.

The following differences information (the sentence above in bold)  is not listed in the article.


Also under the catagory: Linking through the use of page section templates, Other possible templates to create include:   there are two red templates -either broken links or no content in those links.  Need to fix links or add content.


Thanks

Featured Article Committee members

It appears that this section was started and not finished by Darris. Looking back in the page history I found that this section was added on 18 June 2011. I have added a {{ToDo}} template as a reminder that it is incomplete. --Steve (talk| contribs) 16:35, 3 September 2012 (UTC)
  • This page was last modified on 3 September 2012, at 16:35.
  • This page has been accessed 10,188 times.