Fix and test Javadoc generation (#708)

.github/workflows/build.yaml

@@ -45,3 +45,23 @@ jobs:
         run: mvn -version
       - name: Build & Test
         run: mvn -B -Prun-its clean verify
+  javadocs:
+    name: Javadocs
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+        java:
+          - 11
+        maven:
+          - 3.9.6
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: s4u/[email protected]
+        with:
+          java-distribution: 'temurin'
+          java-version: ${{ matrix.java }}
+          maven-version: ${{ matrix.maven }}
+      - name: Build & Test
+        run: mvn -B clean javadoc:jar

CHANGELOG.adoc

@@ -40,6 +40,7 @@ Build / Infrastructure::
   * Add Java 21 to CI (#664)
   * Add Dependabot to automate dependency management (#669)
   * Improvements to dependency management (#690)
+  * Test Javadoc generation in CI (#690)
 
 Documentation::
 

asciidoctor-maven-plugin/src/main/java/org/asciidoctor/maven/process/CopyResourcesProcessor.java

@@ -17,7 +17,7 @@
 /**
  * {@link ResourcesProcessor} implementation that copies all valid resources from
  * a source directory to an output one.
- * <p/>
+ * <p>
  * Following resources are not valid:
  * - AsciiDoc documents: based on file extension.
  * - Asciidoctor Docinfo files.

asciidoctor-parser-doxia-module/src/main/java/org/asciidoctor/maven/site/ast/processors/AbstractSinkNodeProcessor.java

@@ -18,7 +18,10 @@ protected Sink getSink() {
 
     /**
      * Tests for the presence of an attribute in current and parent nodes.
-     * Returns first match.
+     *
+     * @param name attribute name
+     * @param node node to check
+     * @return true if attribute is found
      */
     protected boolean hasAttribute(String name, ContentNode node) {
         ContentNode current = node;