Add javadoc
update README.md with a Documentation section
update README.md with a Bibliography section and some additional data