* add json spec intro

* fix error

* fix name attrs

* rename and move to top

* address boolean values

* update title