message: Add guidelines for when a DOM API belongs here vs on DefinitelyTyped
diff: @@ -30,6 +30,23 @@ The common steps to send a pull request are:
  2. Run the script locally to obtain new `dom.generated.d.ts` and `webworker.generated.d.ts`.
  3. Update the files in the `baselines` folder using the newly generated files.
  +### When should a DOM API be included here?
  +
  +If a DOM API is still a draft, it belongs on [DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped#readme).
  +When it graduates past draft stage, it can be added here and removed from DefinitelyTyped.
  +A feature is considered a draft if:
  +
  +#### W3C
  +
  +A Working Draft should go on DefinitelyTyped.
  +A feature that is a Candidate Recommendation (or has passed that stage) should be added here.
  +
  +#### WhatWG
  +
  +A "Working Draft" ([example](https://whatwg.org/specs/web-controls/current-work/)) should go on DefinitelyTyped.
  +A "Living Standard" ([example](https://xhr.spec.whatwg.org/)) should be added here.
  +
  +
  ## Code Structure
  - `Shared.fs`: handles the parsing from XML spec file, and stores the common data structures for later use.
  