MDN Web Docs on Github

Welcome to the mdn repository! This meta repository contains information, procedures, and resources related to all the repos inside the MDN organization — MDN Web Doc's home on GitHub for code, data, and other resources.

Adding a new project

The MDN organization on GitHub is home to data stores used for various MDN projects, as well as for sample code, tools, and other projects that are useful to web developers as well as people documenting the open web. We encourage contributions to existing projects, as well as the contribution of new projects that help us further our mission to teach web development.

Structure of the MDN organization on GitHub

Describe the structure and hierarchy and where to put different kinds of projects...

Project guidelines

To help ensure consistency and to make using our examples and tools as easy as possible, we have some guidelines for projects on MDN.

Talk about the various guidelines for structuring projects.

Required files

Every project on MDN needs to have the following files, at a minimum:

Some recommendations for your contribute.dist file:

• Under "participate", you should provide URLs that will help potential contributors or users of the project find assistance.
  • "home" should always be a link to the MDN home page.
  • "docs" should be a link to a page that explains the usage of the project, or to the page on MDN most closely affiliated with the example. For example, if the project is an example that's a key part of a guide article on MDN, this URL should refer to that article.
  • "mailing-list" should link to the Category on Discourse or Mozilla mailing list where the reader of the article can get help with the technology or concepts demonstrated by the code. If there is no specific topic or mailing list, then link to the MDN Category on Discourse.
  • "irc" should link to an appropriate place to get help understanding the code. If an appropriate Mozilla IRC channel exists, link to that channel. Otherwise, you can link to the MDN content contributors' channel, #mdn.
• The "keywords" array should be an array of terms which describe the project's purpose or usage. A good guideline is to use the same values we use when tagging MDN articles (except in all lower-case); see How to properly tag pages on MDN.

Making changes to MDN repositories

If you wish to make changes to our code demos or other resources, you don't need special privileges (as described in the section below). The correct process for making changes is to:

• Fork the repo you wish to change.
• Create a new branch to contain your change. Give your branch a descriptive name, such as chrome-bug-fix, or add-object-fit-example.
• Clone your fork locally.
• Make your change.
• Push the branch to your remote fork.
• Make a pull request to the original repo.

If you are not sure how to complete the above steps, GitHub's Fork a Repo guide is a good place to start.

Requesting privileges for MDN repositories

If you wish to become a collaborator on one of our MDN repos (for example, if you wish to help review pull requests), you should make this request by filing an issue in this repository (mdn), or the repo you want to collaborate with. Either is OK.

To become a collaborator, you are required to:

• Agree to abide by our Code of conduct.
• Agree to Mozilla's Commit Access Requirements.
• Set up Two factor authentication on your GitHub account.

Once you have filed your issue, someone from our team will review it, and give you the necessary privileges provided our requirements are satisfied.