Improve upon @royka's initial JSON section

Hey @royka! Thanks for the work you put into building an initial JSON guide in #507.

I took your work and incorporated some of the suggestions made by @sigmavirus24. Please take a look and let me know what you think.