Ignore javadoc errors only if Java8Compatible

and refactor.

Solution inspired by <a href="http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html">Stephen Colebourne's blog: Turning off doclint in JDK 8 Javadoc</a>