We're really happy to accept contributions to the mdn-browser-compat-data repository!
- Before you begin
- Ways to contribute
- Updating compatibility tables on MDN
- Opening issues and pull requests
- Getting help
The browser-compat-data project (BCD) welcomes contributors of all kinds, but we ask that you keep these guidelines in mind when you're contributing.
The project requires that all contributors follow Mozilla's code of conduct and etiquette guidelines.
This project has a formal governance document, which describes how various types of contributors work within the project and how decisions are made.
The repository is made available under the terms the Creative Commons CC0 Public Domain Dedication. Any contributions must be compatible with its terms. If you're not sure about that, please ask.
There are many ways you can help improve this repository! For example:
- Add new compat data: familiarize yourself with the schema and read the schema docs to add new files.
- Fix existing compat data: maybe a browser now supports a certain feature. Yay! If you open a PR to fix a browser's data, it would be most helpful if you include a link to a bug report or similar so that we can double-check the good news.
- Fix a bug: we have a list of issues, or maybe you found your own.
- Review a pull request: there is a list of PRs. Let us know if these look good to you.
It takes up to four weeks for BCD changes to be reflected in MDN's browser compatibility tables. The process is:
-
A pull request is reviewed and merged to
master
. -
Project owners publish a new release of mdn-browser-compat-data. See Publishing a new version of
mdn-browser-compat-data
for details. -
MDN staff build and deploy a new image of Kumascript, which includes the BCD release, to production. This typically happens within a day of the release of the npm package.
-
Tables are generated on MDN:
- Existing tables automatically regenerate monthly. Alternatively, logged-in MDN users can force-refresh a page to regenerate it.
- For new pages, you must add the
{{Compat}}
macro to the page. For instructions, see Inserting the data into MDN pages.
Before submitting your pull request, validate your new data against the schema.
Not everything is enforced or validated by the schema. A few things to pay attention to:
- Feature identifiers (the data namespaces, like
css.properties.background
) should make sense and are spelled correctly. - Nesting of feature identifiers should make sense.
- Notes use correct grammar and spelling. They should be complete sentences ending with a period.
If the feature you're interested in is a JavaScript API, you can cross-reference data against Web API Confluence using the confluence
command. This command overwrites data in your current working tree according to data from the dashboard. See Using Confluence for instructions.
If you need help with this repository or have any questions, contact the MDN team in the #mdn IRC channel on irc.mozilla.org or write us on discourse.