Docs: Add documentation for attr and arrayEx.attr

Author: runegan

lib/attr.js

@@ -1,13 +1,18 @@
 var aeq = (function (aeq) {
 
 /**
- * [description]
+ * Sets or gets an attribute value for all objects in an array. When getting a
+ * value, it only returns the valure from the first object.
  * @memberof aeq
+ * @see aeq.arrayEx.attr
  * @method
- * @param  {array} array         [description]
- * @param  {string} attributeName [description]
- * @param  {Any} newValue      [description]
- * @return {Any}               [description]
+ * @param  {Any[]}  array         The array of objects to get or set attribute
+ *                                values of.
+ * @param  {string} attributeName The name of the attribute to get or set.
+ * @param  {Any}    [newValue]    The value to set. If not given, will only get
+ *                                the value of the first object.
+ * @return {Any|undefined}        When getting, the value of the attribute.
+ *                                When setting, `undefined`.
  */
 aeq.attr = function(array, attributeName, newValue) {
 	var i, il;

lib/objects/array.js

@@ -261,11 +261,15 @@ var arrayEx = {
 	},
 
 	/**
-	 * Checks the arguments length to determine to get or set
-	 * and it needs an object to get or set attributes to.
+	 * Sets or gets an attribute value for all objects in the array. When getting a
+	 * value, it only returns the valure from the first object.
 	 * @method
 	 * @memberof aeq.arrayEx
-	 * @return {type} [description]
+	 * @param {string} attributeName  The name of the attribute to get or set.
+	 * @param  {Any}    [newValue]    The value to set. If not given, will only get
+	 *                                the value of the first object.
+	 * @return {Any}                  when getting, the value of the attribute.
+	 *                                When setting, `undefined`.
 	 * @see aeq.attr
 	 */
 	attr: function() {