fixed json samples in API docs, added short descriptions to main categor...

...y headings on index page, made getting started a little more 'getting started' than just an alphabetic list of articles. Updated the main thing I started doing this for - changing min Java version from 1.6 to 1.7