Update README

Author: donatj

README.md

@@ -36,7 +36,20 @@ Parse strings like foo."bar.baz".quux into [ 'foo', 'bar.baz', 'quux' ]
 function parse(string $path) : array
 ```
 
-Parse a given dot notation path into it's parts
+Parse a given dot notation path into it's parts  
+  
+The path is expected to be a string of dot separated keys, where keys can be  
+quoted with double quotes. Backslashes are used to escape double quotes inside  
+quoted keys.  
+
+##### Examples
+
+- `'foo.bar.baz'` => `[ 'foo', 'bar', 'baz' ]`  
+- `'foo."bar.baz"'` => `[ 'foo', 'bar.baz' ]`  
+- `'foo."bar.baz".quux'` => `[ 'foo', 'bar.baz', 'quux' ]`  
+- `'foo."bar\"baz".quux'` => `[ 'foo', 'bar"baz', 'quux' ]`
+
+**Throws**: `\Quorum\DotNotation\Exceptions\ParseException`
 
 ##### Returns: