change to person JSON
README updates
a bit o' javadoc