Added links and blurb for drag stuff.

tools/dom/docs/docs.json

Index: tools/dom/docs/docs.json
diff --git a/tools/dom/docs/docs.json b/tools/dom/docs/docs.json
index c787feddef5e5fa0f16d9ccc66fcd1de0e144b6b..afa0d81bf79954c296e8864d8755d12b70704e8d 100644
--- a/tools/dom/docs/docs.json
+++ b/tools/dom/docs/docs.json
@@ -562,58 +562,131 @@
         ],
         "dragendEvent": [
           "/**",
-          "   * Static factory designed to expose `dragend` events to event",
-          "   * handlers that are not necessarily instances of [Element].",
+          "   * A stream of `dragend` events fired when an element completes a drag",
+          "   * operation.",
           "   *",
-          "   * See [EventStreamProvider] for usage information.",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
           "   */"
         ],
         "dragenterEvent": [
           "/**",
-          "   * Static factory designed to expose `dragenter` events to event",
-          "   * handlers that are not necessarily instances of [Element].",
+          "   * A stream of `dragenter` events fired when a dragged object is first dragged",
+          "   * over an element.",
           "   *",
-          "   * See [EventStreamProvider] for usage information.",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
           "   */"
         ],
         "dragEvent": [
           "/**",
-          "   * Static factory designed to expose `drag` events to event",
-          "   * handlers that are not necessarily instances of [Element].",
+          "   * A stream of `drag` events fired when an element is currently being dragged.",
           "   *",
-          "   * See [EventStreamProvider] for usage information.",
+          "   * A `drag` event is added to this stream as soon as the drag begins.",
+          "   * A `drag` event is also added to this stream at intervals while the drag",
+          "   * operation is still ongoing.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
+        ],
+        "draggable": [
+          "/**",
+          "   * Indicates whether the element can be dragged and dropped.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
           "   */"
         ],
         "dragleaveEvent": [
           "/**",
-          "   * Static factory designed to expose `dragleave` events to event",
-          "   * handlers that are not necessarily instances of [Element].",
+          "   * A stream of `dragleave` events fired when an object being dragged over an",
+          "   * element leaves the element's target area.",
           "   *",
-          "   * See [EventStreamProvider] for usage information.",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
           "   */"
         ],
         "dragoverEvent": [
           "/**",
-          "   * Static factory designed to expose `dragover` events to event",
-          "   * handlers that are not necessarily instances of [Element].",
+          "   * A stream of `dragover` events fired when a dragged object is currently",
+          "   * being dragged over an element.",
           "   *",
-          "   * See [EventStreamProvider] for usage information.",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
           "   */"
         ],
         "dragstartEvent": [
           "/**",
-          "   * Static factory designed to expose `dragstart` events to event",
-          "   * handlers that are not necessarily instances of [Element].",
+          "   * A stream of `dragstart` events for a dragged element whose drag has begun.",
           "   *",
-          "   * See [EventStreamProvider] for usage information.",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
           "   */"
         ],
         "dropEvent": [
           "/**",
-          "   * Static factory designed to expose `drop` events to event",
-          "   * handlers that are not necessarily instances of [Element].",
+          "   * A stream of `drop` events fired when a dragged object is dropped on an",
+          "   * element.",
           "   *",
-          "   * See [EventStreamProvider] for usage information.",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
           "   */"
         ],
         "errorEvent": [
@@ -770,25 +843,119 @@
           "/// Stream of `doubleclick` events handled by this [Element]."
         ],
         "ondrag": [
-          "/// Stream of `drag` events handled by this [Element]."
+          "/**",
+          "   * A stream of `drag` events fired when this element currently being dragged.",
+          "   *",
+          "   * A `drag` event is added to this stream as soon as the drag begins.",
+          "   * A `drag` event is also added to this stream at intervals while the drag",
+          "   * operation is still ongoing.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
         ],
         "ondragend": [
-          "/// Stream of `dragend` events handled by this [Element]."
+          "/**",
+          "   * A stream of `dragend` events fired when this element completes a drag",
+          "   * operation.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
         ],
         "ondragenter": [
-          "/// Stream of `dragenter` events handled by this [Element]."
+          "/**",
+          "   * A stream of `dragenter` events fired when a dragged object is first dragged",
+          "   * over this element.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
         ],
         "ondragleave": [
-          "/// Stream of `dragleave` events handled by this [Element]."
+          "/**",
+          "   * A stream of `dragleave` events fired when an object being dragged over this",
+          "   * element leaves this element's target area.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
         ],
         "ondragover": [
-          "/// Stream of `dragover` events handled by this [Element]."
+          "/**",
+          "   * A stream of `dragover` events fired when a dragged object is currently",
+          "   * being dragged over this element.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
         ],
         "ondragstart": [
-          "/// Stream of `dragstart` events handled by this [Element]."
+          "/**",
+          "   * A stream of `dragstart` events fired when this element starts being",
+          "   * dragged.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
         ],
         "ondrop": [
-          "/// Stream of `drop` events handled by this [Element]."
+          "/**",
+          "   * A stream of `drop` events fired when a dragged object is dropped on this",
+          "   * element.",
+          "   *",
+          "   * ## Other resources",
+          "   *",
+          "   * * [Drag and drop sample]",
+          "   * (https://github.com/dart-lang/dart-samples/tree/master/web/html5/dnd/basics)",
+          "   * based on [the tutorial](http://www.html5rocks.com/en/tutorials/dnd/basics/)",
+          "   * from HTML5Rocks.",
+          "   * * [Drag and drop specification]",
+          "   * (http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#dnd)",
+          "   * from WHATWG.",
+          "   */"
         ],
         "onerror": [
           "/// Stream of `error` events handled by this [Element]."