Update README.md

(try to) fix markdown for linking to anchor in same page.
Merge pull request #3 from karianna/master

Fixes #1 and #2 + some Javadoc patches
Merge pull request #7 from karianna/master

Fixes #4 - Maven POM enhancements
Remove Javdoc warnings