Guidelines

These guides provide details on how MDN documentation should be written and formatted, as well as how our code samples and other content should be presented. By following these guides, you can ensure that the material you produce is clean and easy to use.

Code example guidelines
This document series outlines the coding guidelines and best practices we use for writing demos, code snippets, interactive examples, etc, for use on MDN.
Does this belong on MDN Web Docs?
In this article, you'll find information describing how to decide whether or not a given topic and/or type of content should be included on MDN Web Docs. We'll also consider other places you might place content, although not in depth.
Editorial policies
This article describes the policies 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.
Guide to classes and styles used in MDN content
MDN has many built-in global styles available for use when styling and laying out articles, and this article is a guide to the available classes and when to use them.
MDN conventions and definitions
This article defines some conventions and definitions that are commonly used on MDN, which might not be obvious to some people when they come across them in the documentation.
Structured data on MDN
MDN stores data in well-defined structures when possible. This information is then centralized and can be updated once, while being used in numerous places.
Video content on MDN
MDN Web Docs is not a very video-heavy site, but there are certain places where video content makes sense to use as part of an article. This article discusses when including videos in MDN articles is appropriate, and provides tips on how to create simple but effective videos on a budget.
Writing style guide
To present documentation in an organized, standardized, and easy-to-read manner, the MDN Web Docs style guide describes how text should be organized, spelled, formatted, and so on. These are guidelines rather than strict rules. We are more interested in content than formatting, so don't feel obligated to learn the style guide before contributing. Do not be upset or surprised, however, if an industrious volunteer later edits your work to conform to this guide.
https://yari-demos.prod.mdn.mozit.cloud/en-US/docs/MDN/Guidelines
yari-demos.prod.mdn.mozit.cloud
crawl=CC-MAIN-2021-43
40476
application/http; msgtype=response
sha1:IEUMTZFLRXRIJD4CWPOUNIB7FNICO4PN
<urn:uuid:fb2951de-2e99-44b9-ab98-310c640ec531>
2021-10-24T21:11:50Z
99.84.102.63
text/html
sha1:SFEK2C6EXZBQNHMQE3ISE5QPP3ULNEHO
<urn:uuid:a8530920-e7e9-4842-b0df-1c859f84744f>
https://yari-demos.prod.mdn.mozit.cloud/en-US/docs/MDN/Guidelines
response
<urn:uuid:a3d3246c-5c0c-4a7e-a594-6156b902d1af>
isPartOf: CC-MAIN-2021-43
publisher: Common Crawl
description: Wide crawl of the web for October 2021
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-80
software: Apache Nutch 1.18 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.2-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/