Docs Clearer with JSON examples
Expanded on Tristan's docs
bugfix-clearer-docs merged into master; resolves #1