More changes to README

Author: Steve Thompson

README.md

@@ -2,6 +2,21 @@
 
 A TypeScript/JavaScript class for general array manipulation.
 
+The main reason you would use PublicArray is if you hate JavaScript's built-in Array methods,  
+like `.slice()`, `.splice()`, `.push()`, and `.shift()`.  PublicArray has much clearer and expressive   
+method names, and a lot more of them.  Examples:
+```
+let arr = getPublicArray([1,2,3,4,5,6]);
+arr.remove.tail(2); // arr.data is now [1,2,3,4]
+arr.remove.head(1); // arr.data is now [2,3,4]
+
+if (arr.notEmpty) arr.prepend([10,11]); // arr.data is now [10,11,2,3,4]
+arr.append([100,200,300]); // arr.data is now [10,11,2,3,4,100,200,300]
+```
+To actually see or get the array itself, you must access PublicArray's `data` property:
+
+`console.log(arr.data); // logs '[10,11,2,3,4,100,200,300]' `
+
 ## Installation
 
 You must have npm installed first.  Then, in the command line:
@@ -34,36 +49,64 @@ getPublicArray(array = []): PublicArray
 
 ### Properties
 
-```
-className: string (read-only)
+#### className: string (read-only)
+
+#### copy: PublicArray (read-only)  
+###### an independent copy of the PublicArray instance
+
+#### data: any[] (read-writable)  
+###### This is the array to be operated on.
+
+#### length: number (read-writable) 
+###### length of array
+
+#### isEmpty: boolean (read-only) 
+###### true if this.data is empty
+
+#### notEmpty: boolean (read-only)
+
+#### filter: PublicArrayFilter (read-only)
+Filter has methods that narrow down the content of the array it contains  
+and return the class instance.
+
+To instantiate, pass the actual array it will contain into its constructor:
 
-copy: PublicArray (read-only) // an independent copy of the PublicArray instance
+    let filter = new PublicArrayFilter( [item1, item2, item3,...] );
 
-data: any[] (read-writable) // This is the array to be operated on.
+You can also reset the array by accessing the class 'data' property:
 
-length: number (read-writable) // length of array
+    filter.data = [1,2,3,4,...];
 
-isEmpty: boolean (read-only) // true if this.data is empty
+These are all its methods:
 
-notEmpty: boolean (read-only)
+        // Narrows down the array to only the values that pass test:
 
-filter: PublicArrayFilter (read-only)
+        byTest(testFunction): this
+        // testFunction = function(currentValue, currentIndex?, theArray?){...}
+        // testFunction must return boolean.
 
-getConverted: PublicArrayGetterConverter (read-only)
+
+        // Narrows down the array to only values that are the specified type:
+
+        byType(
+    	    type: 'number' | 'boolean' | 'string' | 'array' | 'object' | 'function' | 'undefined'
+        ): this
+
+
+#### getConverted: PublicArrayGetterConverter (read-only)
 
-get: PublicArrayGetter (read-only)
+#### get: PublicArrayGetter (read-only)
 
-getAndRemove: PublicArrayGetterRemover (read-only)
+#### getAndRemove: PublicArrayGetterRemover (read-only)
 
-insert: PublicArrayInserter (read-only)
+#### insert: PublicArrayInserter (read-only)
 
-remove: PublicArrayRemover (read-only)
+#### remove: PublicArrayRemover (read-only)
 
-replace: PublicArrayReplacer (read-only)
+#### replace: PublicArrayReplacer (read-only)
 
-sort: PublicArraySorter (read-only)
+#### sort: PublicArraySorter (read-only)
 
-```
 
 ### Methods
 
@@ -92,35 +135,28 @@ endsWith(values: any[]): boolean
 matches(array): boolean
     // returns false if array contains object.
 
-
 // For the next 3 methods:
 // testFunction is a callback with same signature as callback passed to
 // Array.filter() :
 // testFunction(value, index?, theArray?):  checks if value passes test. If yes, it returns true.
 
-
-// returns true if all items pass test.
 allPass(testFunction): boolean
+    // returns true if all items pass test.
 
-
-// returns true if only 1 value passes.
 anyPass(testFunction): boolean
+    // returns true if only 1 value passes.
 
+indexesThatPass(testFunction): number[]
+    // returns all indexes of items that pass test.
 
-	// returns all indexes of items that pass test.
-	indexesThatPass(testFunction): number[]
-
-
-	// Does not work if value is object.
-	firstIndexOf(value): number
+firstIndexOf(value): number
+    // Does not work if value is object.
 
+lastIndexOf(value): number
+    // Does not work if value is object.
 
-	// Does not work if value is object.
-	lastIndexOf(value): number
-
-
-	// Does not work if value is object.
-	indexesOf(value): number[]
+indexesOf(value): number[]
+    // Does not work if value is object.
 
 append(values: any[]): this
 
@@ -135,6 +171,7 @@ protected  _createGetterAndOrSetterForEach(
 	   ) : void 
 	   
 returnThis_after(voidExpression: any) : this
+    // Executes voidExpression and returns this.
     // Even if voidExpression returns something, the returned data isn't used.
 
 runMethod_and_returnThis(
@@ -150,17 +187,16 @@ runMethod_and_returnThis(
 ## Usage
 
 ```
-
 // changing the array content:
 arr.data = [1,2,3,4,5,6,7];
 
 ```
 
 ## Performance
 
-PublicArray has a large number of dependencies.  You should keep this in mind when optimizing the 
-performance of your app. If your code only uses one property of PublicArray, like for 
-instance .replace, you will get a slight performance boost if you just use an instance of
+PublicArray has a large number of dependencies.  You should keep this in mind when optimizing  
+the performance of your app. If your code only uses one property of PublicArray, like for  
+instance `.replace`, you will get a slight performance boost if you just use an instance of  
 PublicArrayReplacer instead:
 ```
 let replace = new PublicArrayReplacer(arr);