In order to improve the quality of our documentation, and our ability to coordinate among the various members of the Mozilla documentation community, we have a process by which documentation is maintained. This article describes how this works and offers useful links to help you ensure that the work you do is as helpful and useful as possible to the community of Web and Mozilla developers.
Getting documentation written
If you're browsing MDN and see a mistake, or a spot where documentation or code sample needs to be added -- or you're a developer and have made a change that should be documented -- you should take steps to help ensure the problem gets fixed. There are a few options here:
- Fix it yourself. It's a wiki, so just click the big blue Edit button at the top of the page and make the required changes. If new documentation needs to be written, you can absolutely do that too. Don't be afraid! We have writers and volunteers that specialize in tidying up your writing and layout if you make mistakes. See Getting started for our guide to contributing to MDN.
- If there's a development bug related to the topic at hand -- say for a new API you've added -- you can add the keyword "dev-doc-needed" to the development bug. This will let the writing team know that a documentation bug needs to be filed. However, it would be preferable if you'd skip this step and instead...
- File a documentation request bug. We have a very handy, easy-to-use form for quickly filing documentation requests.
The official home for all documentation-related issues is the Developer Documentation component in Bugzilla. If your request isn't there, it's very likely not going to get written about!
Filling out the documentation request form
What happens next
Once a documentation request is filed and prioritized, someone will eventually come along and document it. We'll try to do them in order of priority, but there are other factors at play, including availability of people with the needed backgrounds and skills. Just because you've given a documentation bug a high priority level doesn't mean it will automatically be written about ahead of anything else out there. But we will try.
Note: If you keep filing bugs at higher priorities than necessary just to get attention, we'll learn from this and start ignoring you. Be realistic with your requested schedules, please!
Every other week, during the MDN community meeting we hold in the #devmo channel on IRC. This happens on alternate Wednesdays, at 10 AM Pacific Time. At the end of these meetings, we review bugs that have the "dev-doc-needed" keyword on them and determine which ones need bugs filed under Developer Documentation. After the meeting, those bugs get filed and the development bugs get "dev-doc-needed" removed and "doc-bug-filed" added. Alternatively, if the issue is easy to fix and someone fixes it immediately, before a documentation bug is filed, "dev-doc-needed" can be changed directly to "dev-doc-complete".