whatwg/webidl

This repository hosts the Web IDL Standard.

Code of conduct

We are committed to providing a friendly, safe, and welcoming environment for all. Please read and respect the WHATWG Code of Conduct.

Contributing

Good first issues are labeled as a short good first issue.

IDL generally follows the WHATWG Contributor Guidelines and WHATWG Committer Guidelines, except as otherwise noted.

Markup

The specification is written in Bikeshed, plus the Ecmarkup tags <emu-val>, <emu-t>, and <emu-nt>.

Building "locally"

For quick local iteration, run make. To verify your changes locally, run npm install and make deploy. See more in the WHATWG Contributor Guidelines.

Filing issues elsewhere

Breaking changes should be filed against:

• Rendering engines
  • Gecko
  • WebKit
  • Chromium
• web-platform-tests
• idlharness.js (used by testharness.js to run IDL tests)
• Reffy (scrapes IDL from specs for reffy-reports and web-platform-tests)

Syntax changes should be filed against the following parsers:

• widlparser (used by Bikeshed)
• WebIDL parser (used by idlharness.js)
• TypeScript and JavaScript lib generator