MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Editorial policies

The following policies are set by the Mozilla MDN staff to govern the content on MDN web docs. All contributors to MDN web docs are expected to abide by these policies.

Relevance

All content on MDN must be relevant to the technology in whose section it appears. Spam (commercial advertisement) and other irrelevant content will be reverted or deleted upon detection. Users who post spam may be banned from MDN at the discretion of Mozilla staff.

Translated content must appear in the appropriate locale section of MDN. See Translating MDN pages for guidance on how to do this.

Outbound links to commercial sites that are relevant to the topic from which they are linked will be judged on a case-by-case basis. Their value in aiding web developers must outweigh the commercial benefit to the linked site.

Neutrality

MDN web docs contains browser-neutral documentation that enables web developers to write browser-agnostic code.

Web technologies to be documented on MDN should be on a standards track, and be implemented by at least two browsers. Variations in browser support are documented in the browser compatibility section of an article.

Article content on MDN must maintain a neutral point-of-view, reporting on browser variations without editorial bias. Derogatory commentary about any browser is not acceptable.

Note that Mozilla-specific sections of MDN need not be browser-neutral, as they are concerned with Mozilla-specific content; however, they must still maintain a neutral point-of-view.

Structure

Reference pages should follow the same structure as other pages of the same type. See Page Types for a list and examples of common page structures.

Other guidelines

Contributors are expected to follow other guidelines on MDN, for writing style, code samples, CSS, and other topics. Variations from those guidelines in particular cases should be discussed in the MDN discussion forum, presenting the need to do so, or to change the guideline in general, if necessary.

 

Document Tags and Contributors

 Contributors to this page: jswisher
 Last updated by: jswisher,