Improve the Knowledge Base
Revision Information
- Revision id: 119386
- Created:
- Creator: Joni
- Comment: incorporated back some info from the older version; restructured the content for better flow
- Reviewed: No
- Ready for localization: No
Revision Source
Revision Content
Thanks for helping with our Knowledge Base. For millions of people around the world, these articles are the face of Mozilla when they have a problem or question about one of our products. Improving the Knowledge Base is the way to get the biggest bang for our collective effort. A single article can quickly help tens of thousands of people each week.
Here's how the process works in a nutshell:
Ready to begin? Here's a guide to all the training materials you'll need.
Table of Contents
Create an account and say hello
As a nonprofit, open-source project, we rely on our community of volunteers to write and maintain the majority of the articles. You don't need special permission to work on them — this is a wiki that anyone can edit. All you need is an account. Once you've got one, the next thing you should do is say hello:
- Introduce yourself. We'd love to hear from you.
- You can also talk to us in the #sumo IRC channel (chat room). This is where Mozilla support contributors help each other. I'm "jsavage" in there. If you don't have an IRC program, you can connect with this web app.
Learn and practice
Now you're ready to familiarize yourself with the knowledge base. Here are some links to articles to help you get started.
What is an article?
What does an article look like? Learn about an article's anatomy.
Markup and style guides
- Articles are written in a special language called wiki markup before they are published with regular text. Learn to use wiki markup with the wiki mark up chart.
- Learn how to use proper SUMO language and tone in the style guide.
- Our readers use different operating systems and versions of Firefox. Learn to use the For feature to show the right instructions for each operating system and version.
- Templates help us reuse content over and over again. Learn how to use templates.
- Learn how to add screenshots to illustrate your article.
Prepare and practice
- Get practice before you begin working on live articles. Learn about the staging site.
- If you see something that can be better, show the article editing tools and then click Discussion and let us know what needs to be fixed or click Edit Article and make the change yourself. Learn about article discussion.
- Improving the articles we already have is the most common thing we do year round. How do you know which articles need updates and edits? The Knowledge Base Dashboard will list them all. Find out more at KB dashboard.
Ready to write or edit?
These articles will help you get started.
- Learn how to write a new article.
- Learn how to edit articles.
- Each article can be categorized in different ways. Learn how to categorize an article.
Ready to write? Just visit this form: here.
I've submitted a revision. What's next?
Our community reviewers will review your revision in the next week. If you'd like immediate feedback, email Joni Savage, Content Manager, at jsavage@mozilla.com.
Some articles get more visits than others and are treated different in the review process. Learn more about types of articles.