feat(observability): add Javadoc (#1684)

Author: injectives

observation/metrics/pom.xml

@@ -16,6 +16,7 @@
     <description>The Neo4j Java Driver Observation module providing metrics.</description>
 
     <properties>
+        <javadoc.failOnWarnings>false</javadoc.failOnWarnings>
         <maven.deploy.skip>false</maven.deploy.skip>
     </properties>
 
@@ -50,6 +51,15 @@
         </dependency>
     </dependencies>
 
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
     <scm>
         <connection>scm:git:git://github.com/neo4j/neo4j-java-driver.git</connection>
         <developerConnection>scm:git:[email protected]:neo4j/neo4j-java-driver.git</developerConnection>

observation/micrometer/pom.xml

@@ -19,6 +19,7 @@
         <micrometer-docs-generator.inputPath>${project.build.sourceDirectory}/org/neo4j/driver/observation/micrometer</micrometer-docs-generator.inputPath>
         <micrometer-docs-generator.inclusionPattern>.*</micrometer-docs-generator.inclusionPattern>
         <micrometer-docs-generator.outputPath>${project.build.directory}/docs</micrometer-docs-generator.outputPath>
+        <javadoc.failOnWarnings>false</javadoc.failOnWarnings>
         <maven.deploy.skip>false</maven.deploy.skip>
     </properties>
 
@@ -130,6 +131,10 @@
                     </dependency>
                 </dependencies>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+            </plugin>
         </plugins>
     </build>
 

pom.xml

@@ -29,6 +29,7 @@
     <surefire.jpms.args/>
     <failsafe.parallelizable.jpms.args/>
     <failsafe.sequential.jpms.args/>
+    <javadoc.failOnWarnings>true</javadoc.failOnWarnings>
     <!-- Skip deployment by default for everything in this project. -->
     <maven.deploy.skip>true</maven.deploy.skip>
 
@@ -604,7 +605,7 @@
                 <goal>jar</goal>
               </goals>
               <configuration>
-                <failOnWarnings>true</failOnWarnings>
+                <failOnWarnings>${javadoc.failOnWarnings}</failOnWarnings>
               </configuration>
             </execution>
             <execution>