Improve checkstyle rules concerning javadoc

[skapral]

Checkstyle must fail the build if at least one of the rules is violated:

1. An interface or one of its methods are not documented
2. A class, one of its constructors or methods are not documented