Rules and guidelines

From MozillaZine Knowledge Base

Revision as of 12:54, 8 January 2006; view current revision
←Older revision | Newer revision→

Welcome, new and existing editors! Your contributions of Mozilla-related knowledge are most welcome, and you don't need to be an “expert” to help out. In particular, if you have come to the Knowledge Base from the forums after having a question answered or a problem solved, you are encouraged to write up anything that you learnt there, even if you didn’t fully understand why the solution works.

Don’t feel daunted by the rules below; although it helps if you follow them, there will always be other editors willing to tidy your contributions if you don’t have the time to read all the guidelines in the links below. (Please don’t be offended if other editors make such changes; they are just using their own knowledge of the rules.) The important thing is getting your contributions here in the first place!

Of course, if you&rsqou;re planning on becoming a regular contributor then you should try to follow the rules more closely.


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

Avoid superfluous information

  • In Knowledge Base articles, please 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 and helpful in the Talk pages, so please do use them there.

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.

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.

Categorizing articles

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

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: