adding in examples and links

* Adding in an example of using the schema validator
* Adding in a link to 'Understanding JSON Schema' at http://spacetelescope.github.io/understanding-json-schema/
updating per feedback

updating per feedback
Merge remote-tracking branch 'heckj/patch-1'

* heckj/patch-1:
  updating per feedback
  adding in examples and links
Fix a small typo and remove trailing whitespace.