Configure maven-javadoc-plugin to suppress Lombok-related warnings and fix remaining javadoc issues

Co-authored-by: thomasturrell <1552612+thomasturrell@users.noreply.github.com>

Author: Copilot

pom.xml

@@ -119,6 +119,11 @@
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-javadoc-plugin</artifactId>
+          <configuration>
+            <!-- Suppress warnings for Lombok-generated code -->
+            <doclint>all,-missing</doclint>
+            <quiet>true</quiet>
+          </configuration>
           <executions>
             <execution>
               <id>attach-javadocs</id>

xapi-client/src/main/java/dev/learning/xapi/client/XapiClient.java

@@ -160,6 +160,8 @@ public Mono<ResponseEntity<UUID>> postStatement(PostStatementRequest request) {
    * The returned ResponseEntity contains the response headers and the Statement identifier.
    * </p>
    *
+   * @param request the consumer builder for the post statement request
+   *
    * @return the ResponseEntity
    */
   public Mono<ResponseEntity<UUID>> postStatement(Consumer<PostStatementRequest.Builder> request) {
@@ -179,6 +181,8 @@ public Mono<ResponseEntity<UUID>> postStatement(Consumer<PostStatementRequest.Bu
    * identifiers.
    * </p>
    *
+   * @param request the post statements request
+   *
    * @return the ResponseEntity
    */
   public Mono<ResponseEntity<List<UUID>>> postStatements(PostStatementsRequest request) {
@@ -206,6 +210,8 @@ public Mono<ResponseEntity<List<UUID>>> postStatements(PostStatementsRequest req
    * identifiers.
    * </p>
    *
+   * @param request the consumer builder for the post statements request
+   *
    * @return the ResponseEntity
    */
   public Mono<ResponseEntity<List<UUID>>> postStatements(
@@ -225,6 +231,8 @@ public Mono<ResponseEntity<List<UUID>>> postStatements(
    * The returned ResponseEntity contains the response headers and the voided Statement.
    * </p>
    *
+   * @param request the get voided statement request
+   *
    * @return the ResponseEntity
    */
   public Mono<ResponseEntity<Statement>> getVoidedStatement(GetVoidedStatementRequest request) {
@@ -249,6 +257,8 @@ public Mono<ResponseEntity<Statement>> getVoidedStatement(GetVoidedStatementRequ
    * The returned ResponseEntity contains the response headers and the voided Statement.
    * </p>
    *
+   * @param request the consumer builder for the get voided statement request
+   *
    * @return the ResponseEntity
    */
   public Mono<ResponseEntity<Statement>> getVoidedStatement(

xapi-model/src/main/java/dev/learning/xapi/jackson/model/strict/XapiTimestamp.java

@@ -23,7 +23,9 @@ private XapiTimestamp() {
   }
 
   /**
-   * {@inheritDoc} Converts ISO 8601 string to {@link java.time.Instant}.
+   * Converts ISO 8601 string to {@link java.time.Instant}.
+   *
+   * @param text the ISO 8601 timestamp string
    *
    * @return {@link java.time.Instant} of text input
    */