sdk/lib/html/dartium/html_dartium.dart

Index: sdk/lib/html/dartium/html_dartium.dart
diff --git a/sdk/lib/html/dartium/html_dartium.dart b/sdk/lib/html/dartium/html_dartium.dart
index 2267b704924a460d1301c1209a63092c8b13ea5a..d67935841a96b73d2683edbf8cf818959f1f11c5 100644
--- a/sdk/lib/html/dartium/html_dartium.dart
+++ b/sdk/lib/html/dartium/html_dartium.dart
@@ -14046,6 +14046,11 @@ class HttpRequest extends XmlHttpRequestEventTarget {
    *
    * Calling `open` again on a currently active request is equivalent to
    * calling `abort`.
+   *
+   * Note: Most simple HTTP requests can be accomplished using the [getString],
+   * [request], [requestCrossOrigin], or [postFormData] methods. Use of this
+   * `open` method is intended only for more complext HTTP requests where
+   * finer-grained control is needed.
    */
   @DomName('XMLHttpRequest.open')
   @DocsEditable()
@@ -14068,6 +14073,11 @@ class HttpRequest extends XmlHttpRequestEventTarget {
   /**
    * Send the request with any given `data`.
    *
+   * Note: Most simple HTTP requests can be accomplished using the [getString],
+   * [request], [requestCrossOrigin], or [postFormData] methods. Use of this
+   * `send` method is intended only for more complext HTTP requests where
+   * finer-grained control is needed.
+   *
    * See also:
    *
    *   * [send](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#send%28%29)