Found 209 pages:

# Page Tags and summary
1 The MDN project Landing, MDN Meta
MDN Web Docs is a wiki on which we document the open Web, Mozilla technologies, and other developer topics. Anyone is welcome to add and edit content. You don't need to be a programmer or know a lot about technology; there are many different tasks that need to be performed, from the simple (proof-reading and correcting typos) to the complex (writing API documentation).
2 About MDN Collaborating, Community, Copyright, Documentation, Guide, Licenses, MDN Meta
MDN Web Docs is an evolving learning platform for Web technologies and the software that powers the Web, including:
3 Linking to MDN Guide, MDN Meta, Policy
We regularly get users asking us questions about how to link to MDN, or even if doing so is allowed. The short answer is: yes, you can link to MDN! For guidelines and recommendations on best practices, read on!
4 MDN Services Landing, MDN Meta
MDN Services are experimental utilities for web developers designed to fit into existing workflows and help developers improve their web code. All MDN services are in early alpha stages of development, so we do not recommend relying on them for code quality assurance yet. If you like to experiment with prototypes, the services below are ready to try, and we would love to get your feedback on them.
5 MDN reader's guide Documentation, MDN, MDN Meta, Reading MDN
While we strive to make the documentation on MDN Web Docs as clear and readable as possible, it's inevitable that certain conventions or design choices may be confusing to newcomers to the content, or to people not yet familiar with recent design changes. This guide for readers will strive to answer those questions.
6 Promote MDN Guide, MDN Meta
Love MDN? Help share the open-Web goodness with fellow web developers by promoting MDN! We have some ideas of ways you can do that.  We also have wallpapers, stickers, posters, animations, website badges, you name it; link to it from here.
7 Contributing to MDN Guide, Landing, MDN Meta
The guides listed here cover all aspects of contributing to MDN, including style guides, guides to using our editor and tools, and more. Please make sure you have read (and are compliant with) the Mozilla Terms before editing or creating any pages.
8 Document structures Landing, MDN Meta, Structures
Throughout MDN, there are various document structures that are used repeatedly, to provide consistent presentation of information in MDN articles. Here are articles describing these structures, so that, as an MDN author, you can recognize, apply, and modify them as appropriate for documents you write, edit, or translate.
9 API references API, Contribute, Guide, Reference
Client-side JavaScript APIs form a large part of the technology available on the web, and MDN includes extensive reference material to explain what functionality is available in these APIs, and how to use it. In this set of guides we explain how to create API reference material on MDN.
10 API reference sidebars API, Guide, Reference, groupdata, onboarding, sidebars
You are able to include a custom sidebar on API reference pages it so that it displays links to related Interfaces, tutorials, and other resources relevant just to that API. This article explains how.
11 What does an API reference need? API, Reference, onboarding, page types, pages
This article explains what pages are required for a complete API reference.
12 Banners and notices Guide, MDN Meta, Structures
Sometimes, an article needs a special notice added to it. This might happen if the page covers obsolete technology or other material that shouldn't be used in production code. This article covers the most common such cases and what to do.
13 Code examples Code, Examples, Landing, Live, MDN Meta, Static, Structures, interactive
On MDN, you'll see numerous code examples inserted throughout the pages to demonstrate usage of web platform features. This article discusses the different mechanisms available for adding code examples to pages, along with which ones you should use and when.
14 Compatibility tables Guide, MDN Meta, Structures, browser compat, compatibility tables
MDN has a standard format for compatibility tables for our open web documentation; that is, documentation of technologies such as the DOM, HTML, CSS, JavaScript, SVG, and so forth, that are shared across all browsers. This article covers how to use our features to add compatibility data to MDN pages.
15 Live samples Guide, Intermediate, MDN Meta, Structures
MDN supports turning sample code displayed in articles into running samples the reader can look at in action. These live samples can include HTML, CSS, and JavaScript in any combination.
16 A simple demo of a live code sample Example, MDN Meta, Structures
This is a very simple example showing you how to do a live demo in MDN. For more information, see Live samples.
17 Macros Guide, Kuma, KumaScript, MDN Meta, Structures
The Kuma platform on which MDN runs provides a powerful macro system, KumaScript, which makes it possible to do a wide variety of things automatically. This article provides information on how to invoke MDN's macros within articles.
18 Commonly-used macros Reference, Structures
This page lists many of the general-purpose macros created for use on MDN. For how-to information on using these macros, see Using macros and Using link macros.
19 Other macros Macros, Reference
In contrast to the macros listed in Commonly-used macros, the macros documented in this article are used infrequently or only in specific contexts, or are deprecated.
20 Old compatibility tables Compatibility, Guide, MDN Meta, Structures, old
This article documents the old way of adding compatibility data to MDN. If you are adding new compatibility data to MDN, you should be using the new way — see Compatibility tables.
21 Page types Documentation, Guide, MDN Meta, Structures
There are a number of types of pages that are used repeatedly on MDN. This article describes these page types, their purpose, and gives examples of each and templates to use when creating a new page.
22 API constructor subpage template API, Constructor, Template, constructor subpage, reference page
The summary paragraph — start by naming the constructor, and saying what it does. This should ideally be 1 or 2 short sentences. You could copy most of this from the consrtructor's summary on the corresponding API reference page.
23 API event handler subpage template API, Event Handler, Template, event handler subpage, reference page
The summary paragraph — start by naming the event handler, saying what interface it is part of, and saying what it does. This should ideally be 1 or 2 short sentences. You could copy most of this from the property's summary on the corresponding API reference page.
24 API landing page template API, Landing, Template
The summary paragraph — start by naming the API, and saying what it is used for. This should ideally be 1 or 2 short sentences.
25 API method subpage template API, Method, Template, method subpage, reference page
The summary paragraph — start by naming the method, saying what interface it is part of, and saying what it does. This should ideally be 1 or 2 short sentences. You could copy most of this from the method's summary on the corresponding API reference page.
26 API property subpage template API, Property, Template, property subpage, reference page
The summary paragraph — start by naming the property, saying what interface it is part of, and saying what it does. This should ideally be 1 or 2 short sentences. You could copy most of this from the property's summary on the corresponding API reference page. Include whether it is read-only or not.
27 API reference page template API, Template, reference page
The summary paragraph — start by naming the interface, saying what API it is part of, and saying what it does. This should ideally be 1 or 2 short sentences. You could copy most of this from the Interface's summary on the corresponding API landing page.
28 CSS property page template CSS, Property, Reference, Template
The summary paragraph — start by naming the property and saying what it does. This should ideally be 1 or 2 short sentences.
29 CSS selector page template CSS, Reference, Selector, Template
The summary paragraph — start by naming the selector and saying what it does. This should ideally be 1 or 2 short sentences.
30 Glossary page template Glossary, Template, reference page
The TermBeingDefined is ... (include concise definition of the term being defined).
31 HTML element page template Element, HTML, Template, reference page
The summary paragraph — start by naming the element and saying what it does. This should ideally be 1 or 2 short sentences.
32 HTTP header page template HTTP Header, Reference, Template, reference page
The summary paragraph — start by naming the http header and saying what it does. This should ideally be 1 or 2 short sentences.
33 SVG element page template Element, SVG, Template, reference page
The summary paragraph — start by naming the element and saying what it does. This should ideally be 1 or 2 short sentences.
34 Quicklinks Guide, MDN Meta, Structures
MDN supports adding quicklinks to pages; these are boxes containing a potentially hierarchical list of links to other pages on MDN or to pages off-site. This article describes how to create quicklinks boxes.
35 Specification tables Guide, MDN Meta, Structures
Every reference page on MDN should provide information about the specification or specifications in which that API or technology was defined. This article demonstrates what these tables look like and explains how to construct them.
36 Syntax sections API, CSS, HTML, MDN Meta, Structure, Syntax, onboarding
The syntax section of an MDN reference page contains a syntax box defining the exact syntax that a feature has (e.g. what parameters can it accept, which ones are optional?) This article explains how to write syntax boxes for refererence articles.
37 Documentation processes Landing, MDN Meta, Processes
The MDN documentation project is enormous; there are a vast number of technologies we cover through the assistance of hundreds of contributors from across the world. To help us bring order to chaos, we have standard processes to follow when working on specific documentation-related tasks. Here you'll find guides to those processes.
38 Cross-team collaboration tactics for documentation Collaborating, Guide, MDN Meta, Processes
One thing that we've learned at MDN is that when the development team and the documentation team for a given project, API, or technology work closely—and well—together, the documentation quality is incredible. This guide offers some suggested tactics for how the developers and writers can work hand-in-hand.
39 Documentation bugs Guide, MDN Meta, Processes
One of the main ways that that the MDN writing team gets requests for new documentation or documentation changes is through Bugzilla. This article describes how to use bugs to note when documentation updates are needed.
40 Documentation projects MDN Meta, Planning
The MDN community sometimes is tasked with large documentation projects—that is, large amounts of documentation to be written or edited about a specific topic, or a large maintenance project to existing content.
41 MDN's agile process Contribute, Documentation, MDN Meta, Process
The MDN staff team applies an agile process to prioritize and manage projects and tasks, for development of both MDN's content and its platform software (Kuma). The formalized framework that the MDN team's process most closely resembles is Scrum, with modifications to support both content and software development, within the context of Mozilla's Marketing department and its priorities.
42 Requesting elevated privileges Guide, MDN Meta, Processes
Some tools or operations on MDN require elevated access privileges not available to ordinary users.
43 Guide to the MDN editor UI Documentation, Guide, Landing, MDN, MDN Meta
The WYSIWYG (what-you-see-is-what-you-get) editor for the MDN Web Docs wiki makes it easy to contribute new content. This guide shows you how to use the editor and improve your productivity. Please read and comply with the Mozilla Terms before editing or creating new pages.
44 Edit box of the MDN editor MDN Meta, Reference, editor
The edit box is, of course, where you actually do your writing. Right-clicking in the editor box offers appropriate additional options depending on the context of your click: right-clicking in a table offers table-related options and right-clicking in a list offers list-related options, for example.
45 Editor UI elements Beginner, Documentation, Guide, MDN, MDN Meta, editor
The built-in WYSIWYG editor on MDN is designed to make it as easy as possible to create, edit, and improve articles and other pages almost anywhere on the site.
46 Attachments in the MDN editor Beginner, Guide, MDN Meta, editor
EdThe attachments section of the MDN editor lets you upload files to MDN for use in MDN content, as well as see what files are being used by the current document.
47 MDN editor page controls Beginner, Guide, MDN Meta, editor
The page controls consist of buttons affecting the page as a whole. They are visible near both the top and the bottom of the editor view, to save excess scrolling. There are four page control buttons:
48 Page info section of the editor UI Beginner, Guide, MDN Meta, editor
The page info section contains information about the page, but also can be expanded to offer additional page controls.
49 Tags in the MDN editor Beginner, Guide, MDN Meta
Page tags help categorize and organize information for searching and index pages, and they help identify pages that need special attention. Tags are also used to mark pages that are obsolete and may need to be deprecated or even deleted. It's incredibly useful to have good, clean tags on pages as this will help others know any important information, so be sure to have good tags on articles you contribute to.
50 Toolbar of the MDN editor Beginner, MDN Meta, Reference, editor
The editor's toolbar offers features that let you adjust the appearance and flow of the article as you work. This article describes each of the controls in the toolbar.
51 Images Attaching, Documentation, Guide, Images, MDN, MDN Meta, Optimization, attachment, editor
It's frequently useful to include images in articles. Images may be screenshots, examples of what a rendering should look like, or SVG diagrams of program flow, for example. This article describes how to use images in MDN content.
52 Links Documentation, Guide, MDN, MDN Meta, editor
Links are a crucial component to any wiki, not only among many documents, but within a single document, and MDN relies heavily on them. Fortunately, links are also very easy to create, even though there are lots of ways to make them!
53 Redirects Guide, MDN Meta
Sometimes you need to have a page that simply redirects to another page, or to a section of another page. This article describes how to create redirects.
54 Source mode Guide, Intermediate, MDN Meta, NeedsContent, editor
This guide will help you understand what you can do with MDN's wiki content source editing mode, what you should do with it, and, most importantly, what not to do.
55 Syntax highlighting Guide, Howto, MDN Meta, Syntax Highlighting, editor
When you add a code example to an article on MDN, it's helpful to enable syntax highlighting, to make it easy for readers to visually pick out relevant bits of the code. The syntax highlighting mode you select is also used by our live sample rendering system to determine how to use each code snippet when assembling a complete example.
56 Tables Guide, MDN Meta, editor
Tables are a useful way to present information; this article covers how to create and maintain tables on MDN and when you should and should not use them.
57 Guidelines Guidelines, Landing, MDN Meta
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.
58 Code sample guidelines Guide, Guidelines, MDN Meta
The biggest advantage to adhering to these guidelines is that it will foster consistency across our samples and demos on MDN, which increases readability and comprehension overall.
59 Does this belong on MDN Web Docs? Guide, Guidelines, MDN Meta
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.
60 Editorial policies Documentation, MDN, MDN Meta, Writing
This article describes the policies set by the Mozilla MDN staff to govern the content on MDN web docs.
61 MDN CSS guide Guidelines, MDN Meta, Styles
MDN has many built-in global styles available for use when styling and laying out articles — this article serves as a reference guide to what's available, explaining which styles are available and how to use each one.
62 MDN conventions and definitions Documentation, Guide, Guidelines, MDN, MDN Meta
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.
63 Video content on MDN Guidelines, Meta, Video
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.
64 Writing style guide Documentation, Guide, Guidelines, MDN, MDN Meta, MDN Web Docs, MDN style guide, Style guide, 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.
65 How to contribute to docs that are currently needed Getting-started, Guide, How-to, MDN Meta
If you're interested in contributing to MDN, and you're looking for topics to write new content about, this article will help you.
66 Localizing MDN Landing, Localization, MDN Meta, l10n
MDN is used by people all over the world as a reference and guide to Web technologies, as well as to the internals of Firefox itself. Our localization communities are a key part of the Mozilla project; their work in translating and localizing our documentation helps people around the world develop for the open Web. If you'd like to learn more about localization, or even start a new localization, this is the place to begin.
67 Localization projects Community, Localization, MDN Meta, Reference, l10n
All localization and translation work on MDN is done by an amazing community of volunteers. This article lists localization projects, some of their active contributors, and other details.
68 Starting a new MDN localization Documentation, Guide, Localization, MDN Meta, l10n
Localizations of MDN content help extend MDN’s reach to many more web developers and potential web developers than merely those who can read English. Therefore, localizations are a vital part of achieving MDN’s mission.
69 Top 100 articles Localization, MDN, MDN Meta, l10n
The following is a list of the top 100 articles on MDN in terms of traffic. If you want to ensure that your favorite localization covers topics that web developers are likely to be interested in, translating these pages is a good idea.
70 Translating MDN pages Guide, Localization, MDN Meta, Page Translation, l10n
This article is a basic guide to translating content on MDN, including both the mechanics of translation work and tips on the proper way to handle various types of content.
71 MDN tools Landing, MDN Meta
MDN offers a number of features that make it easier to track progress, manage content, and keep up with the latest changes to the site.
72 KumaScript Guide, Kuma, KumaScript, MDN Meta, NeedsContent, Site-wide, Tools
On the Kuma platform that powers MDN, the template system for automating aspects of content on the wiki is called KumaScript. KumaScript is powered by server-side JavaScript, implemented using Node.js.
73 Troubleshooting KumaScript errors Errors, Guide, KumaScript, MDN Meta, Tools
DocumentParsingError errors appear when KumaScript has trouble understanding something in the document itself. The most common cause is a syntax error in a macro.
74 MDN-related add-ons and plug-ins Landing, MDN Meta, Site-wide, Tools
Members of the MDN community have launched many fun and/or useful projects to create tools, add-ons, and utilities that make it easier to use MDN or to contribute to its content.
75 PUT API Advanced, Guide, MDN Meta, Page-level, Tools
The MDN wiki provides an experimental HTTP PUT API for updating documents in whole or by section.
76 Page deletion Guide, MDN Meta, Page-level, Tools
Only MDN administrators are able to delete pages. As a non-admin user, you can request that a page be deleted.
77 Page moving Guide, MDN Meta, Page-level, Tools
The page move tool lets an editor change the URL or slug of a document, and all its sub-pages, in the MDN tree. It is a powerful tool that is very handy when reorganizing pages, or fixing incorrectly positioned pages.
78 Page regeneration Guide, MDN Meta, Page-level, Tools
Because MDN caches rendered content for performance reasons, changes made to source material (such as macro output or transcluded pages) are not automatically reflected in the page. If you expect frequent changes to such source materials, you might want to consider enabling automatic regeneration of your page.
79 Page subscription Guide, MDN Meta, Page-level, Tools
Subscribing to a page on MDN allows you to be notified by email whenever it is updated or changed.
80 RSS feeds Kuma, MDN Meta, Reference, Site-wide, Tools
The MDN wiki offers a number of feeds that you can use to monitor the site.
81 Revision dashboard Guide, MDN Meta, Site-wide, Tools
The revision dashboard is a feature of the MDN Web Docs wiki which lets you look at recent revisions and additions to content on MDN, examine details of what was changed, and act upon those revisions in various ways.
82 Search on MDN Guide, MDN Meta, Site-wide, Tools
The on-site search feature of MDN offers a number of features that may not be available when using an external search engine to search for MDN articles.
83 Special pages Documentation, MDN, MDN Meta, MDN Web Docs, Site-wide, Special Pages, Tools
MDN has a number of "special" pages; these are pages which aren't editable wiki pages, but instead provide information about the site or allow basic maintenance tasks to be performed. This guide briefly describes these special pages.
84 Template editing Guide, MDN Meta, Page-level, Privileges, Roles(2), Tools
Anyone editing MDN wiki pages can invoke templates via macros in MDN articles.  Anyone can create and edit templates via the KumaScript GitHub repository using standard open-source practices (fork the repo, create a branch, make your changes, and submit a pull-request for review).
85 The MDN sample server Advanced, Draft, Guide, MDN Meta, Site-wide, Tools
While MDN's Kuma platform provides a built-in live sample system for presenting simple (and even not-so-simple) code samples with the code's output displayed in-context, there are things that doesn't allow, and there are samples that require a server to talk to. For those things, we have the MDN sample server, which solves these and other problems.
86 URL parameters and document metadata Documentation, Kuma, MDN Meta, Page-level, Reference, Tools
MDN's Kuma wiki platform doesn't have a central API. Instead, our general approach is to offer ways to turn human-accessible resources into machine-friendly data.
87 MDN web docs: How-to guides Documentation, Landing, MDN Meta
These articles provide step-by-step guides to accomplishing specific goals when contributing to MDN.
88 How and when to remove "experimental" macros
Pages on MDN can include KumaScript macros to notify readers that a Web technology feature described by the page is still experimental and not yet standardized.You can help improve MDN by reviewing pages that contain these "experimental" macros, and removing the macros from items that are no longer experimental.
89 How to add or update browser compatibility data MDN Meta
If you have information about browser compatibility of Web features — or are willing and able to do some research and/or experimentation — you can help update MDN's Browser Compatibility Database (BCD).
90 How to be a beta tester MDN Meta
From time to time, as the developers of MDN's Kuma platform make changes to the site, we provide early access to those new features to members who have opted in to be beta testers. As is typical with any "beta" test, features might not work properly in some situations.
91 How to convert code samples to be "live" Beginner, Howto, MDN Meta
Live samples, which let you see what a sample's output looks like, make documentation more dynamic and instructive. This guide covers how to take existing samples and add "live" functionality to them.
92 How to create an MDN account Beginner, Documentation, Guide, Howto, MDN Meta
To edit content on MDN, you need an MDN profile. You don't need a profile if you only want to read and search the MDN docs. This guide will help you set up your MDN profile.
93 How to create an interactive learning exercise Guide, Howto, Intermediate, Learning, MDN Meta, Tutorial
When learning the web, it's important to rely on active learning content. Such content is made to help with learning something pro-actively. It can be exercises, live hackable examples, tasks to perform, assessments, etc. In short, anything that can help someone to actively understand something.
94 distant example
203 MDN Product Advisory Board MDN, PAB, Product advisory board
MDN Web Docs is a trusted source of technical documentation for web developers, built on an open-source web development documentation platform based on wiki technology, which allows virtually anyone to write and edit content.
204 Product Advisory Board Charter & Membership MDN, Membership, PAB, Product advisory board, Terms and conditions
The primary purpose of the PAB is to provide advice, input, and feedback on content strategy, content prioritization, strategic direction, and platform/site features to MDN’s Product Manager and Content Lead. Mozilla will consider input and advice from the PAB; however PAB input and recommendations are non-binding. The primary objectives of the PAB are:
205 Product Advisory Board Members MDN, Members, PAB, Product advisory board
Current members of the MDN Product Advisory Board are:
206 Request for Proposals
A list of all RFPs published by MDN
207 Request for Proposal: MDN Performance Audit
March 5th, 2018
Issued by: Mozilla
Mozilla Representative: Kadir Topal,, Product Manager for MDN
208 Send feedback about MDN Documentation, Guide, MDN, MDN Meta
If you have suggestions for, or are having problems using MDN, this is the right place to be. The very fact that you're interested in offering feedback makes you even more a part of the Mozilla community, and we thank you in advance for your interest.You have several options for offering your insight; this article will help you do so.
209 Signing in to MDN Documentation, MDN, MDN Meta, MDN Project
Whenever you wish to make changes to MDN's content (such as editing, creating, or adding tags to pages), you need to be signed in. This article will explain the process of signing in and the authentication methods we support for identifying you as an MDN contributor.

Document Tags and Contributors

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