docs($http, $httpBackend): docs docs docs

1 files changed, 4 insertions, 1 deletions

diff --git a/src/service/httpBackend.js b/src/service/httpBackend.js
index f18808c6..291d24bb 100644
--- a/src/service/httpBackend.js
+++ b/src/service/httpBackend.js
@@ -15,7 +15,10 @@ var XHR = window.XMLHttpRequest || function() {
  *
  * @description
  * HTTP backend used by the {@link angular.module.ng.$http service} that delegates to
- * XMLHttpRequest object.
+ * XMLHttpRequest object or JSONP and deals with browser incompatibilities.
+ *
+ * You should never need to use this service directly, instead use the higher-level abstractions:
+ * {@link angular.module.ng.$http $http} or {@link angular.module.ng.$resource $resource}.
  *
  * During testing this implementation is swapped with {@link angular.module.ngMock.$httpBackend mock
  * $httpBackend} which can be trained with responses.