Improve Java Json documentation

Attempt to address #2938. I would call this a work in progress; suggestions welcome.

I'm thinking we should point to the Jackson docs as much as possible for more advanced stuff. All we need to do is make sure people know how to create `JsonNode`s.

Would be great to have someone who works more on the Java side take a look at this. @benmccann?