Adjusted HttpRequest documentation to discourage using open and send in simple cases.

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 3b969ac9ed802623389f46400ee648ccf4488f7e..cce4a5232932b88e6be7dc174d952f8163e29cc6 100644
--- a/tools/dom/docs/docs.json
+++ b/tools/dom/docs/docs.json
@@ -359,6 +359,11 @@
           "   *",
           "   * 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.",
           "   */"
         ],
         "overrideMimeType": [
@@ -443,6 +448,11 @@
           "/**",
           "   * 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)",