OGM-651 Add jboss-logging-annotations to javadoc maven plugin

  It is required since the other project don't inlcude it anymore as
  transitive dependency.
OGM-651 Fix doclint warnings
Update comparison version for clirr maven plugin
OGM-684 Wrap DatastoreProvider.start() calls in a ServiceException

This avoid generic exception wrapping from the service layer
OGM-683 Minor typo
OGM-690 Make each datastore a top level chapter and improve generic datastore provider chapter
OGM-673 Mention embedded objects and @Column in MongoDB documentation
OGM-673 Add @AttributeOverride example and one messing with nested structure
OGM-683 Remove reference of ex-experimental features
OGM-683 Move Opt locking section out of the query section (MongoDB)
OGM-683 Various mongodb doc improvements
OGM-683 Improve Neo4J documentation
Minor doc improvement
OGM-683 Add Davide as author
OGM-603 Put mapping and query chapters before datastores

This opens up the ability to add an "API" section between mapping and query
OGM-360 OGM-687 Rework query chapter entirely
OGM-360 Describe various ways to create a native query
OGM-683 Minor fixes in documentation

  * Replace "Builtin" with "Built-in" for consistency
  * Replace "in-entity" with "in entity" for consistency
  * Typos and minor fixes
OGM-603 OGM-516 Add API chapter and clarify what is supported and not
OGM-683 Further documentation improvements