There are lots of ways you can contribute to the Mozilla Developer Network, and not all of them require that you be able to write. Here you'll find a great guide to the kinds of things you can help with, as well as links to lists of specific tasks that need to be taken care of. Whether you're a casual programmer, a core Firefox developer, or one of those Web developers with a million followers on Twitter, you'll find a way to help make MDN better.
How can I help?
Here are some specific suggestions for the kinds of help you might be able to provide, based on the kind of MDN user you are.
Report a problem
While you're reading on MDN, there's always the possibility you'll spot something wrong. There are several possibilities, of course, including missing or inaccurate content, confusing writing, bad formatting, or code samples that don't seem to work. Now, obviously, since MDN is a wiki, the best thing you can possibly do is fix problems you spot yourself. But maybe you don't know the answer or are in the middle of rushing to the hospital or something, and need to jot down the problem so someone can look at it later.
As is the case with all things Mozilla, you report a documentation problem by filing a bug. That's when filing a documentation request bug comes in. Our handy documentation request form will gather the information needed to get us started on fixing the issue.
Of course, our writing community is busy, so sometimes the quickest way to see a documentation problem resolved is to fix it yourself...
Fix an error
Among the easiest things you can do to help is copy-edit existing content. If you see something wrong, fix it! If you think something is unclear, try to make it better. We love it when people fix typos and do the little things to make MDN just a little better, because this is the kind of detail work that makes content shine!
A few helpful resources:
Add or update page tags
Page tags help categorize and organize information, and help us identify pages that need special attention. Tags are also used to mark pages that are obsolete and may need to be deprecated or even deleted. It's incredibly useful to have good, clean tags on pages, and you can help!
There are several types of problems with tags you can help fix:
If you see one (or more) of these problems, you can help by logging into MDN, then clicking the Edit button at the top right of the MDN window. Once the editor loads up, scroll down to the bottom of the page, where you'll see the tag box, which looks like this:
- No tags
- All articles should have at least one tag, and usually more than one. Generally, at a minimum, articles should have at least a "category" tag and a "topic" tag. Often other tags are appropriate as well, but if you can help us ensure that at least these are present, you'll be a documentation hero!
- Incorrect tags
- Missing tags
- Tag spam
- This insidious beast is the most revolting tag problem of all: some Web vermin has deposited its droppings in the tags for a page, leaving a page with tags like "Free warez!" or "Hey I was browsing your site and wanted to ask you if you could help me solve this problem I'm having with Flash crashing all the time". These need to be deleted posthaste!
Adding a tag
To add a new tag, simply click in the box and start typing:
Here we see the three already existing tags (as button-like objects) and our new tag as unadorned text. When we press Enter or Tab key (or comma), the new tag is committed to the list, and the list looks like this:
For a list of recommended tags, as well as a usage guide for specific tags, please see MDN tagging standards.
Removing a tag
There are two ways to remove a tag: you can click on the "x" icon next to its name in its button, or you can click to its right in the editor box and press the delete key on your keyboard.
Committing your changes
Your changes are not saved unless you click one of the save buttons at the top of the editor window. Scroll back to the top of the window if you don't see the buttons, then click one of the two green save buttons. Now your change has been committed.
Add or update content
There are always things that can be added or updated on MDN. Whether it's all-new documentation for a sparkling new API or a revision to an older API that's changed subtly, you'll find lots of opportunities to help.
When writers add or make changes to articles, they have the option of marking the article as being in need of review. That is, they can indicate that someone should look over the article to ensure its quality. There are two kinds of review:
- Technical review
- A technical review is where someone with strong knowledge on the topic covered by the article reads the article and ensures that it is technically and factually accurate. They either take notes and send them along to the writer(s) or make corrections in-page themselves (the latter being the preferable approach).
- Editorial review
- An editorial review is one in which the reviewer reads the article and corrects typos, grammatical mistakes, and formatting or layout problems. This also involves ensuring that the article matches the MDN style guide.
Articles in need of review have one or both of these banners across the top of the page:
Your mission (if you choose to accept it) is to read over the article and review its contents. Obviously, you should only technically review articles whose technology you understand well, and similarly, you should only perform an editorial review if you're reasonably good at the language in which the article is written.
Finding articles to review
While you can certainly stumble upon articles for which reviews are needed while browsing MDN, there's also a way to get an actual list of flagged articles:
If you read over the article and there aren't any problems, you don't have to open the article editor to mark the article as "reviewed." Instead, you can use the "quick review" box at the bottom of the page. It looks something like this:
Simply toggle on the checkbox(es) for the reviews you've performed and click "Confirm reviews". If you're not logged into MDN, you'll be prompted to log in. Then this will update the article's review flags appropriately.
On the other hand, perhaps you've reviewed the article but had to make some changes, so you're in the editor. You can mark off the article as having been reviewed here, too.:
In this case, you need to toggle off the checkboxes for the reviews you've performed, then save the article.
Add a code sample