Java API doc page improvements

@jacek-lewandowski, I made a few updates and improvements to the Java page after running through some examples.

Fixes #275