docs($q): explain what the $q service does in description

btelles · caitp · commit 3b3de3f87639 · 2014-11-14T11:12:27.000-05:00
Explain what the $q service does in description, instead of origin document. The original explanation was less accessible to people new to promises and JS in general. Closes #10056
diff --git a/src/ng/q.js b/src/ng/q.js
@@ -6,7 +6,11 @@
  * @requires $rootScope
  *
  * @description
- * A promise/deferred implementation inspired by [Kris Kowal's Q](https://github.com/kriskowal/q).
+ * A service that helps you run functions asynchronously, and use their return values (or exceptions) 
+ * when they are done processing. 
+ * 
+ * This is an implementation of promises/deferred objects inspired by 
+ * [Kris Kowal's Q](https://github.com/kriskowal/q).
  *
  * [The CommonJS Promise proposal](http://wiki.commonjs.org/wiki/Promises) describes a promise as an
  * interface for interacting with an object that represents the result of an action that is

Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,11 @@`
`6`	`6`	`* @requires $rootScope`
`7`	`7`	`*`
`8`	`8`	`* @description`
`9`		`- * A promise/deferred implementation inspired by [Kris Kowal's Q](https://github.com/kriskowal/q).`
	`9`	`+ * A service that helps you run functions asynchronously, and use their return values (or exceptions)`
	`10`	`+ * when they are done processing.`
	`11`	`+ *`
	`12`	`+ * This is an implementation of promises/deferred objects inspired by`
	`13`	`+ * [Kris Kowal's Q](https://github.com/kriskowal/q).`
`10`	`14`	`*`
`11`	`15`	`* [The CommonJS Promise proposal](http://wiki.commonjs.org/wiki/Promises) describes a promise as an`
`12`	`16`	`* interface for interacting with an object that represents the result of an action that is`