The readability of JavaDocs severely suffers when enforcing fully-qualified names for types not used in the actual source code. CheckStyle can be adapted to not raise an error if it detects such an "unused" import.

We couldn't reach agreement on this in the whole team, but I'd still love to enable this at least for OGM. The referenced types are present at runtime in the very most - if not all - cases and even if they were not, imports per se are not reflected in class files (only the actual usage of types is baked into method signatures etc.), so I don't think there is any negative consequence to this.