Rules and guidelines: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
(→‎Organizing articles: Templates/Rules, out!)
Line 9: Line 9:


==Style guidelines==
==Style guidelines==
Please have a look at [[In-House Style]]. We're trying to give the knowledge base a uniform look, and you can help by following these guidelines as much as possible.
Please have a look at [[In-house style]]. We're trying to give the knowledge base a uniform look, and you can help by following these guidelines as much as possible.


==Editing courtesy==
==Editing courtesy==

Revision as of 13:11, 7 November 2005

Creating new articles

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.

Please read and follow the article naming conventions when creating new articles or moving existent ones. You don't have to read that if you only edit existing pages.

Categorizing articles

To allow people to find information more easily, it is helpful to use categories when editing or creating articles.

Style guidelines

Please have a look at In-house style. We're trying to give the knowledge base a uniform look, and you can help by following these guidelines as much as possible.

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 Talk 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

Play with wiki on the following pages, and only on them.

  • 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.

Talking to authority: