diff --git a/README.md b/README.md
index 5d354f1ed..d8a04817d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,796 @@
-[](https://github.com/nlohmann/json/releases)
+[JSON Data Set Sample
+The JSON output from different Server APIs can range from simple to highly nested and complex. The examples on this page attempt to illustrate how the JSON Data Set treats specific formats, and gives examples of the different constructor options that allow the user to tweak its behavior. See our JSON Primer for more information.
+
+Example 1 - JSON Array with simple data types as elements.
+Example 2 - JSON Array with objects as elements
+Example 3 - JSON Object
+Example 4 - The "path" constructor option.
+Example 5 - The "path" constructor option and JSON Array with objects as elements.
+Example 6 - The "subPaths" constructor option with a single path.
+Example 7 - The "subPaths" constructor option with multiple paths.
+Example 8 - "path" constructor option example.
+Example 9 - Multiple matches for a single sub path.
+Example 10 - Multiple matches for multiple sub paths.
+Example 11 - The JSON Nested Data Set.
+Example 12 - Sorting with the JSON Nested Data Set
+Be sure to check out the "What's Not Supported" section.
+
+Example 1
+If the JSON data describes an array, and each element of that array is of a basic type (number, string, boolean, or null):
+
+[ 100, 500, 300, 200, 400 ]
+the JSON DataSet will create a row for each element in the JSON array, and store its value in a column named "column0".
+
+var dsExample1 = new Spry.Data.JSONDataSet("../../data/json/array-01.js");
+
+...
+
+
+ Values from array: {column0}
+
+Here is a live example:
+
+Values from array: 100 500 300 200 400
+Example 2
+If the JSON data describes an array, and each element of that array is an object:
+
+[
+ {
+ color: "red",
+ value: "#f00"
+ },
+ {
+ color: "green",
+ value: "#0f0"
+ },
+ {
+ color: "blue",
+ value: "#00f"
+ },
+ {
+ color: "cyan",
+ value: "#0ff"
+ },
+ {
+ color: "magenta",
+ value: "#f0f"
+ },
+ {
+ color: "yellow",
+ value: "#ff0"
+ },
+ {
+ color: "black",
+ value: "#000"
+ }
+]
+the JSON Data Set will create a row for each object in the array, and each property on the object will become a column.
+
+var dsExample2 = new Spry.Data.JSONDataSet("../../data/json/array-02.js");
+
+
+...
+
+
+ Values from array: {color}({value})
+
+Here's a live example:
+
+Values from array: red(#f00) green(#0f0) blue(#00f) cyan(#0ff) magenta(#f0f) yellow(#ff0) black(#000)
+
+
+Example 3
+If the JSON data describes an object:
+
+{
+ color: "red",
+ value: "#f00"
+}
+the JSON Data Set will create a single row for the object, and each property on the object will become a column. The data set will only contain one row of data.
+
+var dsExample3 = new Spry.Data.JSONDataSet("../../data/json/array-03.js");
+
+
+...
+
+
+Values from object: {color}({value})
+
+Here is a live example:
+
+Values from object: red(#f00)
+
+
+Example 4
+The objects returned from most Server APIs are highly nested:
+
+{
+ "id": "0001",
+ "type": "donut",
+ "name": "Cake",
+ "ppu": 0.55,
+ "batters":
+ {
+ "batter":
+ [
+ { "id": "1001", "type": "Regular" },
+ { "id": "1002", "type": "Chocolate" },
+ { "id": "1003", "type": "Blueberry" },
+ { "id": "1004", "type": "Devil's Food" }
+ ]
+ },
+ "topping":
+ [
+ { "id": "5001", "type": "None" },
+ { "id": "5002", "type": "Glazed" },
+ { "id": "5005", "type": "Sugar" },
+ { "id": "5007", "type": "Powdered Sugar" },
+ { "id": "5006", "type": "Chocolate with Sprinkles" },
+ { "id": "5003", "type": "Chocolate" },
+ { "id": "5004", "type": "Maple" }
+ ]
+}
+If the data you want to extract out is not at the top-level of the JSON object, you can tell the JSON data set where to find it by using the "path" constructor option. In this example, we want to extract out all of the "batter" data:
+
+var dsExample4 = new Spry.Data.JSONDataSet("../../data/json/object-02.js", { path: "batters.batter" });
+
+...
+
+
+
+The path is simply the set of properties used to traverse the object's structure, separated by dots. Here's a live example:
+
+Batters:
+
+Regular (1001)
+Chocolate (1002)
+Blueberry (1003)
+Devil's Food (1004)
+
+
+Example 5
+In the case where you have an array of highly nested objects:
+
+[
+ {
+ "id": "0001",
+ "type": "donut",
+ "name": "Cake",
+ "ppu": 0.55,
+ "batters":
+ {
+ "batter":
+ [
+ { "id": "1001", "type": "Regular" },
+ { "id": "1002", "type": "Chocolate" },
+ { "id": "1003", "type": "Blueberry" },
+ { "id": "1004", "type": "Devil's Food" }
+ ]
+ },
+ "topping":
+ [
+ { "id": "5001", "type": "None" },
+ { "id": "5002", "type": "Glazed" },
+ { "id": "5005", "type": "Sugar" },
+ { "id": "5007", "type": "Powdered Sugar" },
+ { "id": "5006", "type": "Chocolate with Sprinkles" },
+ { "id": "5003", "type": "Chocolate" },
+ { "id": "5004", "type": "Maple" }
+ ]
+ },
+ {
+ "id": "0002",
+ "type": "donut",
+ "name": "Raised",
+ "ppu": 0.55,
+ "batters":
+ {
+ "batter":
+ [
+ { "id": "1001", "type": "Regular" }
+ ]
+ },
+ "topping":
+ [
+ { "id": "5001", "type": "None" },
+ { "id": "5002", "type": "Glazed" },
+ { "id": "5005", "type": "Sugar" },
+ { "id": "5003", "type": "Chocolate" },
+ { "id": "5004", "type": "Maple" }
+ ]
+ },
+ {
+ "id": "0003",
+ "type": "donut",
+ "name": "Old Fashioned",
+ "ppu": 0.55,
+ "batters":
+ {
+ "batter":
+ [
+ { "id": "1001", "type": "Regular" },
+ { "id": "1002", "type": "Chocolate" }
+ ]
+ },
+ "topping":
+ [
+ { "id": "5001", "type": "None" },
+ { "id": "5002", "type": "Glazed" },
+ { "id": "5003", "type": "Chocolate" },
+ { "id": "5004", "type": "Maple" }
+ ]
+ }
+]
+the JSON data set uses the "path" constructor option to extract the matching data out from each object in the array. Each match then becomes a row in the data set. In this example, we want the data set to select all of the "batter" objects and flatten them into rows:
+
+var dsExample5 = new Spry.Data.JSONDataSet("../../data/json/array-03.js", { path: "batters.batter" });
+
+
+...
+
+
+Here's a live example:
+
+Batters:
+
+Regular (1001)
+Chocolate (1002)
+Blueberry (1003)
+Devil's Food (1004)
+Regular (1001)
+Regular (1001)
+Chocolate (1002)
+
+
+Example 6
+Some JSON formats use nested structures to simply group data together. An example of this would be the "image" and "thumbnail" properties in the following example:
+
+{
+ "id": "0001",
+ "type": "donut",
+ "name": "Cake",
+ "image":
+ {
+ "url": "images/0001.jpg",
+ "width": 200,
+ "height": 200
+ },
+ "thumbnail":
+ {
+ "url": "images/thumbnails/0001.jpg",
+ "width": 32,
+ "height": 32
+ }
+}
+It is sometimes desirable to flatten these structures so they are also available as columns in the data set. You can use the "subPaths" constructor option to tell the JSON Data Set to include these nested structures when it flattens the top-level JSON object, or the data selected by the "path" constructor option. In this particular example, because we have not specified a "path" constructor option, the JSON data set will attempt to flatten the top-level object. Since we want to also include the data from the "image" nested structure, we specify the path to the data which is simply "image".
+
+var dsExample6 = new Spry.Data.JSONDataSet("../../data/json/object-03.js", { subPaths: "image" });
+
+...
+
+
+
+
+ | id |
+ type |
+ name |
+ image.width |
+ image.height |
+ image.url |
+
+
+ | {id} |
+ {type} |
+ {name} |
+ {image.width} |
+ {image.height} |
+ {image.url} |
+
+
+
+
+
+ | id |
+ type |
+ name |
+ image.width |
+ image.height |
+ image.url |
+ thumbnail.width |
+ thumbnail.height |
+ thumbnail.url |
+
+
+ | {id} |
+ {type} |
+ {name} |
+ {image.width} |
+ {image.height} |
+ {image.url} |
+ {thumbnail.width} |
+ {thumbnail.height} |
+ {thumbnail.url} |
+
+
+
+
+
+ | id |
+ type |
+ name |
+
+
+ | {id} |
+ {type} |
+ {name} |
+
+
+
+
+
+ | id |
+ type |
+ name |
+ batter |
+
+
+ | {id} |
+ {type} |
+ {name} |
+ {batters.batter.type} |
+
+
+
+
+
+ | id |
+ type |
+ name |
+ batter |
+ topping |
+
+
+ | {id} |
+ {type} |
+ {name} |
+ {batters.batter.type} |
+ {topping.type} |
+
+
+
+
+ -
+ {dsExample11_Items::name}
+
+ - Batters:
+
+ - {dsExample11_Batters::type}
+
+
+ -
+ Toppings:
+
+ - {dsExample11_Toppings::type}
+
+
+
+
+
+
+
+
+
+
+
+ | id |
+ type |
+ name |
+ batter |
+
+
+
+ | {dsExample12_Items::id} |
+ {dsExample12_Items::type} |
+ {dsExample12_Items::name} |
+ {dsExample12_Batters::type} |
+
+
+
+ |
+
+
+ -
+ {dsExample12_Items::name}
+
+ - Batters:
+
+ - {dsExample12_Batters::type}
+
+
+
+
+
+ |
+
+
+