Added pretty-printed JSON examples for DOC-168, fixed rst subheadings
Merge pull request #2980 from edx/ahodges/documentation/prettyprint

Added pretty-printed JSON examples for DOC-168, fixed rst subheadings