Community guidelines

👋 Welcome to MDN Web Docs, an open-source, collaborative project that documents web platform technologies, including HTML, CSS, JavaScript, and Web APIs. We also provide extensive learning resources for early-stage developers and students.

Ways to contribute

Community resources

Communication channels

This page lists communication channels used by the MDN team and our community, with hints on which might be best for you.


This section explains how you can start contributing and the type of contributions we accept. It covers Getting started, Our repositories, Translated content, and Security vulnerability response steps.

Open source etiquette

This article gives guidance on how to behave when contributing to our open source project including rules for contributing, etiquette, and how to handle conflicts.


Issues are used to track all bugs and work that has a clear actionable outcome. This article contains guidelines on opening and working on issues and also covers Issue triage and Content and feature suggestions.

Pull requests

This section covers our guidelines for submitting pull requests and what you should expect from the review process.

Roles and teams

This section provides an overview of the users and teams that are part of the MDN Web Docs project and details what it means to be part of a team.

Code of conduct

By participating in and contributing to our projects and discussions, you acknowledge that you have read and agree to the Mozilla community participation guidelines.

Get in touch

You can communicate with the MDN Web Docs team and community using the communication channels.

General support

We are a small team working hard to keep up with the documentation demands of a continuously changing web ecosystem. Unfortunately, we can't help with general support questions. If you're learning to code, you can refer to the following resources:

Any issues, discussions, or pull requests opened on repositories asking for general support will be directed here and may be closed and locked.