# MDN Web Docs

The platform code behind MDN Web Docs

Repository: https://github.com/mdn/yari
Canonical: https://ross.abutalabs.com/products/mdn-web-docs
Language: TypeScript
License: MPL-2.0
License Family: copyleft
Topics: yari, mdn
Last push: 2026-09-02T10:33:14+00:00
Link (homepage): https://developer.mozilla.org
Link (site_page): https://developer.mozilla.org/en-US/docs/Web/HTML
Link (site_page): https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements
Link (site_page): https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes
Link (site_page): https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 48, longevity 100
- inputs: {"age_days": 2660, "days_push": 0, "days_rel": 350, "gap_med": 5.5, "n_releases_24m": 51}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1299, forks 553 (observed 2026-09-03T02:15:14.846609+00:00)

## What it is
MDN Web Docs is the open-source, community-maintained documentation project for web technologies, containing over 14,000 pages of reference and learning content on HTML, CSS, JavaScript, HTTP, and Web APIs. The mdn/content repository holds the Markdown source of the documentation, rendered by the yari platform at developer.mozilla.org.

## Use cases
- look up HTML element and attribute references
- learn web development from beginner tutorials
- check browser compatibility data for web APIs
- find CSS and JavaScript code examples
- contribute to or translate web documentation
- run MDN docs locally for offline reading

## When to choose
- you need authoritative reference material for web platform technologies
- you are a beginner looking for structured web development tutorials
- you want to contribute to or localize web documentation
- you need browser compatibility information for features

## When to avoid
- you need documentation for non-web technologies like Python or Rust
- you want a runnable software tool rather than documentation content
- you need guaranteed up-to-the-minute coverage of brand-new experimental APIs

## Facets
- artifact type: learning-resource
- maturity: stable
- function: documentation, developer-tools
- domain: web-development, documentation, frontend, tutorials
- platform: cross-platform
- tags: mdn, web-standards, reference, html, css, javascript, web-apis, http, open-source-documentation, localization, web-server, nodejs

## Member repositories
- mdn/yari (main) score 82
- mdn/content (docs) score 77
- mdn/learning-area (examples) score 77
- mdn/browser-compat-data (sdk) score 95
- mdn/webextensions-examples (examples) score 75
- mdn/dom-examples (examples) score 74
- mdn/translated-content (docs) score 77
- mdn/kuma (backend) score 10
- mdn/django-locallibrary-tutorial (examples) score 76
- mdn/webaudio-examples (examples) score 68
- mdn/web-speech-api (examples) score 10
- mdn/mdn (docs) score 73
- mdn/express-locallibrary-tutorial (examples) score 73
- mdn/js-examples (examples) score 56
- mdn/webgl-examples (examples) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:14.846609+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:17:17.799030+00:00, confidence not recorded.
  - readme: https://github.com/mdn/yari (fetched 2026-09-03T02:15:14.846609+00:00, sha 1a30428bc6e2)
  - homepage: https://developer.mozilla.org (fetched 2026-08-29T08:18:59.444614+00:00, sha caf521516d21)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML (fetched 2026-08-29T08:18:59.454176+00:00, sha 66bf4a25f44a)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements (fetched 2026-08-29T08:18:59.456351+00:00, sha a6c21ef2f053)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes (fetched 2026-08-29T08:18:59.459028+00:00, sha e2025dfddb5b)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes (fetched 2026-08-29T08:18:59.461063+00:00, sha dc19bdcf5efd)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference (fetched 2026-08-29T08:18:59.463388+00:00, sha e154bd54ce2b)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Responsive_images (fetched 2026-08-29T08:18:59.465066+00:00, sha 8807d18c08e4)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Cheatsheet (fetched 2026-08-29T08:18:59.467244+00:00, sha 797cb95cf18e)
  - site_page: https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Date_and_time_formats (fetched 2026-08-29T08:18:59.468986+00:00, sha f9a25082e203)
- Data as of 2026-08-30T08:39:29.467469+00:00.