Add readme

Author: shawncplus

README.md

@@ -0,0 +1,51 @@
+`Biddle.MemoizationBehavior` allows you to define a computed property
+as memoizable (http://en.wikipedia.org/wiki/Memoization) with `_memoizeComputed`
+or more generally memoize any given function with `_memoize`
+
+To implement a computed property as memoizable in the simplest fashion (although
+this is a trivial example, you would likely only want to memoize expensive functions)
+
+    behaviors: [
+        Biddle.MemoizationBehavior,
+    ],
+
+    properties: {
+        firstName: String,
+        lastName: String,
+        fullName: {
+            type: String,
+            computed: '_memoizeComputed("fullName", firstName, lastName)'
+            method: '_getFullName'
+        }
+    },
+
+    _getFullName: function (first, last) {
+        return first + ' ' + last;
+    }
+
+Given that the default hash function is `JSON.stringify` which may be inappropriate
+for object/array parameters you may wish to override the default hashing method
+for a specific property.
+
+    properties: {
+        foo: Object,
+        bar: Object,
+        foobar: {
+            type: String,
+            computed: '_memoizeComputed("fullName", foo, bar)'
+            method: '_computeFoobar',
+            hashFn: (foo, bar) => foo.id + ':' + bar.id
+        }
+    },
+
+To generally memoize any function you may do the following
+
+    var someValue = this._memoize(this.someExpensiveFunction)(arg2, arg2, arg3);
+
+Cache invalidation happens manually with the `_invalidateMemoizeCache` method
+
+    var foo = this._memoize(this.bar)('Hello');
+    // ...
+    this._invalidateMemoizeCache(this.bar);
+
+