chore: documentation fixes and additions

Author: spence-s

README.md

@@ -114,7 +114,9 @@ for instance
 const lhs = { foo: 'bar', biz: { foo: 'baz' } };
 const rhs = { foo: 'bar', biz: { foo: 'buzz' } };
 
-hrDiff(lhs, rhs, { prefilter: ['foo'] });
+const { diff } = new HumanDiff({ prefilter: ['foo'] });
+
+diff(lhs, rhs);
 ```
 
 You would still see the diffs for `biz.foo` but you would ignore the diff for `foo`.
@@ -143,6 +145,8 @@ const prefilter = (path, key) => path[0] === 'foo' && key === 'bar';
 
 ## A Note On Arrays
 
+> \*\*There are known bug related to arrays of objects. We plan to release different array processing algorithms in the future that can handle more complex objects. As of the latest version it is reccomended to only diff between flat arrays of strings and numbers. Otherwise there isn't guarantee of accuracy or if diffs won't be duplicated in some ways.
+
 `human-object-diff` parses arrays in an opinionated way. It does it's best to resolve Arrays into groups of insertions and removals. Typical diff libraries look at arrays on an element by element basis and emit a difference for every changes element. While this is benefical for many programatic tasks, humans typically don't look at arrays in the same way. `human-object-diff` attempts to reduce array changes to a number of insertions, removals, and edits. An example can better describe the difference.
 
 ```js
@@ -164,6 +168,17 @@ Consider the above arrays and their differences. A typical array diff would beha
 
 This is much more understandable to a human brain. We've simply inserted a number at an index.
 
+## Diff Memory
+
+The diff engine object created when `new HumanDiff()` is invoked contains a `sentences` property which you can use to recall the last diff that was computed.
+
+```js
+const diffEngine = new HumanDiff();
+diffEngine.diff(lhs, rhs);
+
+diffEngine.sentences; // -> same as the output of the last diff
+```
+
 ## Contributors
 
 | Name               | Website                    |