Provide a way to contribute docs to dart:html

[kasperpeulen]

The dart:html library is very short of documentation. I think the least I can ask is a way to help making it better :)

I think it would be much easier, if there was one yaml file, with documentation that gets kind of injected in the generated html library. Something like:

Element.style: |
  /// Returns an object that represents the element's style attribute. See the
  /// [CSS Properties Reference](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Properties_Reference)
  /// for a list of the CSS properties accessible via [style].
  ///
  /// Example usage:
  ///
  ///     var textArea = querySelector('textarea');
  ///     textArea.style.height = 'auto';
  ///
  /// ## Other resources
  ///
  /// * [Element.style](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/style) at MDN.
Element.getBoundingClientRect: |
  /**
   * Returns the smallest bounding rectangle that encompasses this element's
   * padding, scrollbar, and border.
   *
   * ## Other resources
   *
   * * [Element.getBoundingClientRect]
   * (https://developer.mozilla.org/en-US/docs/Web/API/Element.getBoundingClientRect)
   * from MDN.
   * * [The getBoundingClientRect() method]
   * (http://www.w3.org/TR/cssom-view/#the-getclientrects-and-getboundingclientrect-methods)
   * from W3C.
   */

Or maybe even only the text (without the doc syntax). cc @alan-knight

[kasperpeulen]

Do I understand correctly from this issue:
#23601

that if I want to contribute to dart:html docs, I have to to edit docs.json file? @alan-knight

https://github.com/dart-lang/sdk/blob/master/tools/dom/docs/docs.json

[alan-knight]

Unfortunately, at the moment I believe that's correct.