Rules and guidelines

From MozillaZine Knowledge Base
Revision as of 02:47, 27 March 2005 by Hao2lian (talk | contribs) (Newline spacing.)
Jump to navigationJump to search

Note that the rules below are in the process of being revised. See Talk:Rules and In-House Style for details.

Before Creating a New Article

Before you create a new article in the knowledge base, check to see if the topic hasn't already been covered somewhere. Do a search and browse the relevant articles. You don't want to waste time by adding information that already exists.

Naming Conventions

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

Specify the Application

When you create a new article, 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. If the article applies to two or more products, omit the parentheses and do not specify the applications in the title.

Examples where the article applies to just one application:

Examples where the article applies to two or more applications:

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" or "Thunderbird", "Nvu", "Sunbird", "Camino" 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.

  • Bad: [[Bookmarks (Mozilla Firefox)]]
  • Bad: [[Profile locked (Suite)]]

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

Use Short Titles

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)]]

Capitalization

Don't write The Whole Title In Capital Letters.

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

This is allowed when the article name is a (or contains a) term that is begins with a capital letter, e.g. Search Bar. See In-House Style for the list of common terms.

Article Categories

(Please refer to the discussion at Talk:Rules/Categories until the guidelines for categories are finalized and written up.)

Editing Courtesy

  • Any time you edit a page, please add a short comment in the "Summary" field about the change you made. This makes it easier for others to see what has changed. Importantly, it can help make it easier for us to distinguish knowledge base spamming/vandalism from legitimate contributions.
  • If you find yourself wanting to change an entry back to an earlier revision, ask yourself if the current version had a useful purpose, and whether it really is necessary to change it back.
  • Document reasons for potentially controversial changes on the Talk pages.
  • Accept changes to your entries in a spirit of helpfulness.
  • If someone consistently makes certain types of mistakes or formatting quirks, consider placing a message in their User page.

Superfluous Information

  • In knowledge base articles, do not insert signatures, links to sites that are not related to Mozilla products, or other superfluous information. If you want to give a link to your own personal website, for example, then put it in your User page, not in the article. In short, if the information or link is not directly related to the topic of the article, then don't include it in the article.
  • Of course, signatures are welcome (even helpful) in the Talk pages, so do not hesitate to use them there.

Test Editing Pages

  • A sandbox for showing off the wiki's features.
  • Another test page - Now with extra markup tests!
  • If you want to do some silly tests using a page use this page.