Documentation priority list
This document defines the different priority tiers on MDN, and states what documentation topics exist inside each tier — we are calling them Tier 1 and Tier 2.
The purpose of this document is two-fold:
- To help apply priority measures to content bugs during our triage process, which in turn helps contributors to make a decision about what bugs to work on by finding out which ones are most important right now.
- To help contributors that want to work on a specific topic area rather than a specific bug decide which one would be most useful to give their time to (for example, folks that like to run automated cleanup scripts on MDN).
The relative importance of these docs has been decided purely by looking at page view figures. There are lots of measures we could have used, but page views is objective and still a good indicator — more important web technologies are looked up more often, and therefore fixing problems with those docs seems most critical.
Also bear in mind that these Tiers are made up of isolated document trees (i.e. the linked page, plus all of the documents in the hierarchy below it). Sometimes a Tier 1 document will link to a Tier 2 document, or vice versa, and that is OK.
The numbers in parentheses after each document tree represent the number of documents under that tree. These numbers will likely change over time, so may need revisiting before too long.
Tier 1 content is the most important content on MDN — it has the most users, and is deemed to cover the most important technologies for the web platform.
Learn web development (355)
Progressive web apps (16)
- Canvas API (112)
- Clipboard API (13)
- DOM (439)
- DOM Events (22)
- Fetch API (47)
- File API (48)
- HTML DOM (371)
- URL API (43)
- Web Storage API (8)
- WebSockets API (28)
- XMLHttpRequest (58)
Web App Manifests (19)
Web components (5)
Total Tier 1 pages: 4150
Tier 2 content is less commonly-used, but useful nonetheless.
- CSS Houdini (1)
- Game development docs (73)
- Guides (56)
- MathML (38)
- MDN meta-documentation (82). This is important, but fixes would be mainly dealt with by the MDN core team)
- SVG (382)
- The MDN Web Docs glossary (534)
- WebAPIs that aren’t in the “Tier 1 WebAPIs” list (4701)
- WebExtensions (635). Not really web platform, but still important)
Total Tier 2 pages: 6502
There is other content on MDN that is outside our web platform technology remit — such as archived content and Firefox-specific docs (e.g. DevTools, platform internals). This content has been deprioritized completely, and in most cases we are trying to find new homes for it, or delete it if it is no longer useful. We would not recommend that our community spends any time working on any areas not specifically listed on this page.
Tier 1 WebAPIs
The following API interface reference documents (and their child pages) are currently considered Tier 1. For more information on the rationale for these groupings and priorities, see the work done in https://github.com/mdn/sprints/issues/3327.
Canvas API (111)
Clipboard API (13)
Note: “DOM” is only a partial group — we only included the interface docs with the highest page views, to keep the size of Tier 1 down to a manageable number. Other DOM interfaces not in this list are in Tier 2.
DOM Events (22)
Note: “DOM Events” is only a partial group — we only included the interface docs with the highest page views, to keep the size of Tier 1 down to a manageable number. Other DOM Events interfaces not in this list are in Tier 2.
Fetch API (39)
File API (48)
HTML DOM (371)
Note: “HTML DOM” is only a partial group — we only included the interface docs with the highest page views, to keep the size of Tier 1 down to a manageable number. Other HTML DOM interfaces not in this list are in Tier 2.