Article naming conventions: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
(→‎Specify the application: - how does this look?)
(→‎Punctuation marks or symbols: added comma and question mark as examples of symbols to avoid. Added examples for article names that are exceptions)
 
(12 intermediate revisions by 6 users not shown)
Line 4: Line 4:
In general, try to use [http://en.wikipedia.org/wiki/Wikipedia:Naming_conventions Wikipedia's Naming conventions] except when these differ from what is described below.
In general, try to use [http://en.wikipedia.org/wiki/Wikipedia:Naming_conventions Wikipedia's Naming conventions] except when these differ from what is described below.


===Specifying the application===
==Specifying the application==
For some articles, you should specify the application to which the article applies by putting "Firefox", "Thunderbird", or "Mozilla Suite" in parentheses at the end of the name of the article. Please do this '''only if''' the article applies exlusively to one application and needs to be distinguished from similarly titled articles for other applications (see examples below). Do '''not''' include the application name if the article applies to two or more applications, or if the article is about a feature that exists in only one application. If you are not sure if the application name should be included in the title, just leave it out and someone else can add it later if necessary.
For some articles, you should specify the application to which the article applies by putting "Firefox", "Thunderbird", or "Mozilla Suite" after a dash at the end of the name of the article. Please do this '''only if''' the article applies exlusively to one application and needs to be distinguished from similarly titled articles for other applications (see examples below). Do '''not''' include the application name if the article applies to two or more applications, or if the article is about a feature that exists in only one application. If you are not sure if the application name should be included in the title, just leave it out and someone else can add it later if necessary.


Examples where the application name ''is'' included in the article title:
Examples where the application name ''is'' included in the article title:
* [[Upgrading (Firefox)]]
* [[Standard diagnostic - Firefox]]
* [[Upgrading (Thunderbird)]]
* [[Standard diagnostic  - Thunderbird]]
* [[Links (Mozilla Suite)]]
* [[Links - Mozilla Suite]]
* [[Links (Thunderbird)]]
* [[Links - Thunderbird]]


Examples where the application name is ''not'' included in the article title:
Examples where the application name is ''not'' included in the article title:
* [[Profile folder]] — applies to Firefox, Thunderbird, and Mozilla Suite
* [[Profile Manager]] — applies to Firefox, Thunderbird, and Mozilla Suite
* [[Junk Mail Controls]] — applies to Thunderbird and Mozilla Suite
* [[Junk Mail Controls]] — applies to Thunderbird and Mozilla Suite
* [[Search Bar]] — Firefox-specific feature
* [[Search Bar]] — Firefox-specific feature
Line 21: Line 21:
'''Note''': this is a change from the old naming convention, in which article titles indicated whether articles were "FAQs", "Tips", or "Issues" (e.g., [[Thunderbird : FAQs : Global Inbox]]). Many of the existing articles were created under the old naming system and have not yet been renamed. Please do '''not''' follow this old naming system when creating new articles.
'''Note''': this is a change from the old naming convention, in which article titles indicated whether articles were "FAQs", "Tips", or "Issues" (e.g., [[Thunderbird : FAQs : Global Inbox]]). Many of the existing articles were created under the old naming system and have not yet been renamed. Please do '''not''' follow this old naming system when creating new articles.


===Application names===
==Application names==
Application name links should only use the application name, such as "Firefox", "Thunderbird", "Nvu", "Sunbird", or "Camino" and '''not''' "Mozilla Firefox", "Mozilla Thunderbird" or "Linspire Nvu". The exception is the Mozilla Suite, which should be linked to and called "Mozilla Suite", not "Mozilla", "Suite", "Seamonkey", or any other name.
Application name links should only use the application name, such as "Firefox", "Thunderbird", "Nvu", "Sunbird", or "Camino" and '''not''' "Mozilla Firefox", "Mozilla Thunderbird" or "Linspire Nvu". The exception is the Mozilla Suite, which should be linked to and called "Mozilla Suite", not "Mozilla", "Suite", or any other name.
* Bad: <nowiki>[[Bookmarks (Mozilla Firefox)]]</nowiki>
* Bad: <nowiki>[[Bookmarks - Mozilla Firefox]]</nowiki>
* Bad: <nowiki>[[Profile locked (Suite)]]</nowiki>
* Bad: <nowiki>[[Profile locked - Suite]]</nowiki>
Layout issues or other things should use Gecko as the application name.
Layout issues or other things should use Gecko as the application name.


===Use short titles===
==Use short titles, with key words at the beginning==
When possible, use short page titles. There's no need for a link to include the entire grammatically complete form of a question, especially when a few descriptive words would suffice.  
When possible, use short page titles. There's no need for a link to include the entire grammatically complete form of a question, especially when a few descriptive words would suffice.  
* Good: <nowiki>[[Send page or link (Mozilla Suite)]]</nowiki>
* Good: <nowiki>[[Send page or link - Mozilla Suite]]</nowiki>
* Bad: <nowiki>[[Use Send Page or Send Link to tell your friends about a great webpage (Mozilla Suite)]]</nowiki>
* Bad: <nowiki>[[Use Send Page or Send Link to tell your friends about a great webpage - Mozilla Suite]]</nowiki>
Avoid putting the word "Using" at the beginning of the title when a shorter title would work fine.
Try to avoid putting a word like "using" or "changing" at the beginning of the title when title will work fine without it. This will help as we move to categories, in which articles will be sorted alphabetically by title.
* OK: <nowiki>[[Using keyword searches]]</nowiki>
* OK: <nowiki>[[Using keyword searches]]</nowiki>
* Better: <nowiki>[[Keyword searches]]</nowiki>
* Better: <nowiki>[[Keyword searches]]</nowiki>


===Capitalization===
==Capitalization==
Do '''not''' capitalize The First Letter of Each Main Word in the Title.
Do '''not''' capitalize The First Letter of Each Main Word in the Title.
*Good: <nowiki>[[Importing and exporting your mail]]</nowiki>
*Good: <nowiki>[[Importing and exporting your mail]]</nowiki>
*Bad: <nowiki>[[Importing and Exporting Your Mail]]</nowiki>
*Bad: <nowiki>[[Importing and Exporting Your Mail]]</nowiki>


Exception: terms such as [[Search Bar]] and [[Junk Mail Controls]], which refer to named product features and function as proper nouns, should be capitalized in article titles. See [[In-House Style]] for a list of common terms to be capitalized.
Exception: terms such as [[Search Bar]] and [[Junk Mail Controls]], which refer to named product features and function as proper nouns, should be capitalized in article titles. See [[In-house style]] for a list of common terms to be capitalized.
 
==Punctuation marks or symbols==
Avoid using [http://en.wikipedia.org/wiki/Punctuation punctuation marks] or typographical symbols in article names, since exclamation points, parentheses, apostrophes, commas, question marks, and other symbols may cause broken links when the article's [http://en.wikipedia.org/wiki/Uniform_Resource_Locator URL] is used on web forums or in mail and newsgroup messages, unless [http://en.wikipedia.org/wiki/Percent-encoding#Types_of_URI_characters percent-encoding] is used.  [http://forums.mozillazine.org/viewtopic.php?f=38&t=740765]
*Bad: <nowiki>[[Yahoo! Music videos don't work]] </nowiki>
*Bad: <nowiki>[[Standard diagnostic (Thunderbird)]] </nowiki> 
 
Exceptions include  article names that contain file names (e.g., <nowiki>[[Corrupt localstore.rdf]]</nowiki>),  articles named for [[:Category:Preferences|preferences]] or about:protocols (e.g., <nowiki>[[about:config]]</nowiki>), and when using a dash (hyphen) as in those cases [[#Specifying the application |noted above]] when specifying the application.

Latest revision as of 20:42, 27 June 2009

This page describes the rules you must follow when creating new articles or moving existing ones.

In general, try to use Wikipedia's Naming conventions except when these differ from what is described below.

Specifying the application

For some articles, you should specify the application to which the article applies by putting "Firefox", "Thunderbird", or "Mozilla Suite" after a dash at the end of the name of the article. Please do this only if the article applies exlusively to one application and needs to be distinguished from similarly titled articles for other applications (see examples below). Do not include the application name if the article applies to two or more applications, or if the article is about a feature that exists in only one application. If you are not sure if the application name should be included in the title, just leave it out and someone else can add it later if necessary.

Examples where the application name is included in the article title:

Examples where the application name is not included in the article title:

Note: this is a change from the old naming convention, in which article titles indicated whether articles were "FAQs", "Tips", or "Issues" (e.g., Thunderbird : FAQs : Global Inbox). Many of the existing articles were created under the old naming system and have not yet been renamed. Please do not follow this old naming system when creating new articles.

Application names

Application name links should only use the application name, such as "Firefox", "Thunderbird", "Nvu", "Sunbird", or "Camino" and not "Mozilla Firefox", "Mozilla Thunderbird" or "Linspire Nvu". The exception is the Mozilla Suite, which should be linked to and called "Mozilla Suite", not "Mozilla", "Suite", or any other name.

  • Bad: [[Bookmarks - Mozilla Firefox]]
  • Bad: [[Profile locked - Suite]]

Layout issues or other things should use Gecko as the application name.

Use short titles, with key words at the beginning

When possible, use short page titles. There's no need for a link to include the entire grammatically complete form of a question, especially when a few descriptive words would suffice.

  • Good: [[Send page or link - Mozilla Suite]]
  • Bad: [[Use Send Page or Send Link to tell your friends about a great webpage - Mozilla Suite]]

Try to avoid putting a word like "using" or "changing" at the beginning of the title when title will work fine without it. This will help as we move to categories, in which articles will be sorted alphabetically by title.

  • OK: [[Using keyword searches]]
  • Better: [[Keyword searches]]

Capitalization

Do not capitalize The First Letter of Each Main Word in the Title.

  • Good: [[Importing and exporting your mail]]
  • Bad: [[Importing and Exporting Your Mail]]

Exception: terms such as Search Bar and Junk Mail Controls, which refer to named product features and function as proper nouns, should be capitalized in article titles. See In-house style for a list of common terms to be capitalized.

Punctuation marks or symbols

Avoid using punctuation marks or typographical symbols in article names, since exclamation points, parentheses, apostrophes, commas, question marks, and other symbols may cause broken links when the article's URL is used on web forums or in mail and newsgroup messages, unless percent-encoding is used. [1]

  • Bad: [[Yahoo! Music videos don't work]]
  • Bad: [[Standard diagnostic (Thunderbird)]]

Exceptions include article names that contain file names (e.g., [[Corrupt localstore.rdf]]), articles named for preferences or about:protocols (e.g., [[about:config]]), and when using a dash (hyphen) as in those cases noted above when specifying the application.