docs for new @key unescaping and keypath helper methods

Author: evs-chris

docs/edge/Keypaths.md.hbs

@@ -66,4 +66,8 @@ ractive = new Ractive({
 });
 
 ractive.get( 'letters[0]' ); // returns undefined
-```
+```
+
+## Escaping
+
+While not ideal, sometimes properties of objects have `.`s in name e.g. `foo['bar.baz']`. Note that while numbers are supported in array notation, strings are not. To access a peypath with a literal `.` in one of the keys, you can escape it with a `\` e.g. `foo.bar\.baz`. Any keys accessible in the template will be unescaped, so if you're trying to use them with simple string concatenation to access a keypath with a `.` in it, you'll need to make sure you escape it first.

docs/edge/Migrating.md.hbs

@@ -16,7 +16,7 @@ There is now support for linking data to extra keypaths in the model. This is pa
 
 You can now use ES2015 object literal shorthand in templates e.g. `{ foo }` is equivalent to `{ foo: foo }`.
 
-If you have object keys with `.`s in them, you can now escape them with a `\`. So if you have a `bar` object with a `foo.baz` property, it can be accessed with `bar.foo\.baz`. Keys and keypaths in the template are given as escaped paths so that they can be used directly with Ractive methods.
+If you have object keys with `.`s in them, you can now escape them with a `\`. So if you have a `bar` object with a `foo.baz` property, it can be accessed with `bar.foo\.baz`. Keypaths in the template are given as escaped paths so that they can be used directly with Ractive methods. There are also a few new static methods on `Ractive` to deal with escaping, unescaping, splitting, and joining keypaths.
 
 `<textarea>`s now handle HTML content as plain text to match what happens in browsers. They can now also set up two-way binding with a single interpolator as content instead of using the value attribute e.g. `<textarea>\{{someBinding}}</textarea>` is equivalent to `<textarea value="\{{someBinding}}"></textarea>`.
 

docs/edge/Ractive.escapeKey().md.hbs

@@ -0,0 +1,12 @@
+---
+title: Ractive.escapeKey()
+---
+
+Escapes the given key so that it can be concatenated with a keypath string e.g. `foo.bar` => `foo\.bar`.
+
+> ### Ractive.escapeKey( key )
+> Returns the properly escaped key.
+
+> > ### **key** *`String`*
+> > The key to escape.
+

docs/edge/Ractive.joinKeys().md.hbs

@@ -0,0 +1,12 @@
+---
+title: Ractive.joinKeys()
+---
+
+Joins the given keys into a properly escaped keypath e.g. `Ractive.joinKeys( 'foo', 'bar.baz' )` => `'foo.bar\.baz'`.
+
+> ### Ractive.joinKeys( ...keys )
+> Returns the properly joined and escaped keypath.
+
+> > ### **keys** *`Strings`*
+> > The keys to join into an escaped keypath.
+

docs/edge/Ractive.splitKeypath().md.hbs

@@ -0,0 +1,13 @@
+---
+title: Ractive.splitKeypath()
+---
+
+Splits the given keypath into an array of unescaped keys e.g. `Ractive.splitKeypath( 'foo.bar\.baz' )` => `[ 'foo', 'bar.baz' ]`.
+
+> ### Ractive.splitKeypath( keypath )
+> Returns an array of unescaped keys.
+
+> > ### **keypath** *`String`*
+> > The keypath to split into keys.
+
+

docs/edge/Ractive.unescapeKey().md.hbs

@@ -0,0 +1,12 @@
+---
+title: Ractive.unescapeKey()
+---
+
+Unescapes the given key e.g. `foo\.bar` => `foo.bar`.
+
+> ### Ractive.unescapeKey( key )
+> Returns the properly unescaped key.
+
+> > ### **key** *`String`*
+> > The key to unescape.
+

templates/edge/partials/left-nav.md.hbs

@@ -119,9 +119,13 @@
 	</ul>
 	<h2>Static methods</h2>
 	<ul>
+		<li>{{{createLink 'Ractive.escapeKey()'}}}</li>
 		<li>{{{createLink 'Ractive.extend()'}}}</li>
 		<li>{{{createLink 'Ractive.getNodeInfo()'}}}</li>
+		<li>{{{createLink 'Ractive.joinKeys()'}}}</li>
 		<li>{{{createLink 'Ractive.parse()'}}}</li>
+		<li>{{{createLink 'Ractive.splitKeypath()'}}}</li>
+		<li>{{{createLink 'Ractive.unescapeKey()'}}}</li>
 	</ul>
 	<h2>Static properties</h2>
 	<ul>