Added gitter and a nice example.

Author: nedtwigg

README.md

@@ -7,7 +7,8 @@ output = [
 	link(shield('License Apache', 'license', 'Apache', 'blue'), 'https://tldrlegal.com/license/apache-license-2.0-(apache-2.0)'),
 	'',
 	link(shield('Changelog', 'changelog', '{{version}}', 'brightgreen'), 'CHANGES.md'),
-	link(image('Travis CI', 'https://travis-ci.org/{{org}}/{{name}}.svg?branch=master'), 'https://travis-ci.org/{{org}}/{{name}}')
+	link(image('Travis CI', 'https://travis-ci.org/{{org}}/{{name}}.svg?branch=master'), 'https://travis-ci.org/{{org}}/{{name}}'),
+	link(shield('Live chat', 'gitter', 'live chat', 'brightgreen'), 'https://gitter.im/{{org}}/{{name}}')
 	].join('\n');
 -->
 [![Maven artifact](https://img.shields.io/badge/mavenCentral-com.diffplug.jscriptbox%3Ajscriptbox-blue.svg)](https://bintray.com/diffplug/opensource/jscriptbox/view)
@@ -17,17 +18,41 @@ output = [
 
 [![Changelog](https://img.shields.io/badge/changelog-3.1.0--SNAPSHOT-brightgreen.svg)](CHANGES.md)
 [![Travis CI](https://travis-ci.org/diffplug/jscriptbox.svg?branch=master)](https://travis-ci.org/diffplug/jscriptbox)
+[![Live chat](https://img.shields.io/badge/gitter-live_chat-brightgreen.svg)](https://gitter.im/diffplug/jscriptbox)
 <!---freshmark /shields -->
 
+When exposing a scripting API, you provide some variables and functions to the script, run the script, then look at which outputs were set and/or functions were called.  JScriptBox provides a mechanism for exposing a Java API to a scripting language in a way which is independent of the script language.  This means that if you write your code using JScriptBox, script authors can use any language supported by JSR-223, such as JavaScript, Ruby, Python, Scheme, [etc.](http://stackoverflow.com/a/14864450/1153071).
+
+At present, only JavaScript is being used in the wild (in the [FreshMark](https://github.com/diffplug/freshmark) project), but PR's which enhance support for other languages are welcome.
+
+## Example
 
 <!---freshmark javadoc
 output = prefixDelimiterReplace(input, 'https://{{org}}.github.io/{{name}}/javadoc/', '/', stable);
 -->
 
+```java
+private int square(int x) {
+	return x * x;
+}
+
+@Test
+public void example() throws ScriptException {
+	TypedScriptEngine engine = JScriptBox.create()
+		.set("square").toFunc1(this::square)
+		.set("x").toValue(9)
+		.buildTyped(Nashorn.language());
+	int squareOfX = engine.eval("square(x)", Integer.class);
+	Assert.assertEquals(81, squareOfX);
+}
+```
+
+In the code above, we provide a `square`  function and an `x` variable.  We then build a Nashorn Javascript engine, but we could have passed any other language just as easily.
+
 <!---freshmark /javadoc -->
 
 ## Acknowledgements
-* Scripts run by [JScriptBox](https://github.com/diffplug/jscriptbox).
+* Readme formatting by [FreshMark](https://github.com/diffplug/freshmark).
 * Bugs found by [findbugs](http://findbugs.sourceforge.net/), [as such](https://github.com/diffplug/durian-rx/blob/v1.0/build.gradle?ts=4#L92-L116).
 * Scripts in the `.ci` folder are inspired by [Ben Limmer's work](http://benlimmer.com/2013/12/26/automatically-publish-javadoc-to-gh-pages-with-travis-ci/).
 * Built by [gradle](http://gradle.org/).

src/test/java/com/diffplug/scriptbox/javascript/JScriptBoxNashornTest.java

@@ -25,9 +25,24 @@
 import org.junit.Test;
 
 import com.diffplug.jscriptbox.JScriptBox;
+import com.diffplug.jscriptbox.TypedScriptEngine;
 import com.diffplug.jscriptbox.javascript.Nashorn;
 
 public class JScriptBoxNashornTest {
+	private int square(int x) {
+		return x * x;
+	}
+
+	@Test
+	public void example() throws ScriptException {
+		TypedScriptEngine engine = JScriptBox.create()
+				.set("square").toFunc1(this::square)
+				.set("x").toValue(9)
+				.buildTyped(Nashorn.language());
+		int squareOfX = engine.eval("square(x)", Integer.class);
+		Assert.assertEquals(81, squareOfX);
+	}
+
 	@Test
 	public void testBasicExpressions() throws ScriptException {
 		ScriptEngine engine = JScriptBox.create().build(Nashorn.language());