Getting started on MDN

We are an open community of developers building resources for a better Web, regardless of brand, browser, or platform. Anyone can contribute and each person who does makes us stronger. Together we can continue to drive innovation on the Web to serve the greater good. It starts here, with you.

Every part of MDN (docs, demos, and the site itself) are created by an open community of developers. Please, join us!

4 simple steps to MDN

MDN is an open source resource where anyone can add and edit contents. You don't need to be a programmer or know a lot about technologies. There are plenty of things that need to be done, from the simple (proofreading and correcting typos) to the complex (writing API documentation).

Contributing is easy and safe. Even if you make a mistake, it's easily fixed. Even if you don't know exactly how things should look, or your grammar isn't all that good, don't worry about it! We have a team of people whose job it is to make sure that MDN's contents are as good as possible. Someone will be along to make sure your work is tidy and well-written. Share what you know and follow your strengths.

Step 1: Create an account on MDN

To begin your contributions to MDN, you need to have an account on MDN. We presently allow authentication via Google accounts and GitHub accounts — if you have one of these, you can use it to create an MDN account.

To create an MDN account:

  1. If you are not signed in to MDN, you'll see a Sign in link at the top-right of any page. Select this link.
  2. You'll now be given two options, Sign in the GitHub and Sign in with Google. Choose the one that you want to authenticate with on MDN.
  3. You'll now be prompted to sign in to your chosen account / authenticate with it to continue on to MDN. Follow the on-screen instructions.
  4. When you come back to MDN, you'll be prompted to create a username and specify a few other credentials, and after that you'll be logged into MDN.

In future if you want to log into MDN again you can just use the same authentication mechanism you used previously.

Step 2: Pick a task to complete

Now that you are logged in, read the descriptions of the different task types available on the main Contribute page, and decide which one most appeals to you. You can pick any task you like and begin your contribution.

Step 3: Do the task

Once you've decided what kind of task you want to do, find a specific page, code example, etc. to work on, and just do it!

Step 4: Ask for help

If you are not sure what to do at any point, then you are more than welcome to ask for help. There are a few different help options:

  • If you want to talk to us synchronously and ask questions about MDN itself, join the discussion on the MDN Web Docs chat room on Matrix.
  • You can also drop us an email at mdn-admins@mozilla.org.
  • If you are learning web development and are stuck on a coding problem, we have active forums where you can ask questions and get help.

Don't worry about doing it perfectly; other MDN contributors are here to help fix errors that slip through. If you want to experiment before doing something "for real", you can edit the Sandbox page.