more doc & pom improvements
preparing for a release