Don't bury the lead.   This is the hot stuff.  
curl -s "http://some.json.api.com/data/you/will/take/our/stupid/format/and/like/it" | jolt transform -i transformSpec.json | jolt sort
curl -s "http://some.host.com/stuff/data.json" | jolt diffy -i moreData.json | jolt sort 

Put this at the top. 


Sections should be 
1) Purpose  ( show the awesome pipe example )
2) Setup 
3) Reference