FamilySearch Wiki talk:Manual of StyleEdit This Page

From FamilySearch Wiki

(Difference between revisions)
m (Proposals being discussed)
(Missing information in section 4.3: section needs completing)
 
(10 intermediate revisions by 7 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 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]].   
Line 17: Line 17:
 
== Proposals being discussed  ==
 
== Proposals being discussed  ==
  
#[[FamilySearch Wiki:Separator for Items in See Also Section]]
+
#Table of Contents: To Hide or Display by Default
#[[FamilySearch Wiki:Buttons|Buttons]]
+
#[[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)  
 
#[[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 talk:Breadcrumb Trails|Breadcrumb Trails]]  
Line 38: Line 39:
 
#[[FamilySearch Wiki:Spelling in the English-language Wiki|Spelling in the English-language wiki]]  
 
#[[FamilySearch Wiki:Spelling in the English-language Wiki|Spelling in the English-language wiki]]  
 
#[[FamilySearch Wiki:Naming a Project|Naming a project]]  
 
#[[FamilySearch Wiki:Naming a Project|Naming a project]]  
#[[FamilySearch Wiki talk:Web Sites versus websites|Web sites or websites]]
+
#[[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?  ==
 
== What to do with Help:Naming Conventions?  ==
Line 45: Line 47:
  
 
:I support the proposal to move [[Help:Naming conventions]] to the ''FamilySearch Wiki'' namespace. --[[User:Cottrells|Steve]] 09:25, 16 October 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:WuehlerAC|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.
 +
 
 +
 
 +
 
 +
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.
 +
 
 +
 
 +
 
 +
Thanks
  
== A Place to Start ==
+
[[:Category:Featured Article Committee members|Featured Article Committee members]] –
  
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)
+
: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)

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,173 times.