Problem

The javadoc publication workflow failed for repositories like sonar-plugin-api that generate multiple javadoc artifacts:

• sonar-plugin-api-13.0.0.3026-javadoc.jar (main API docs)
• sonar-plugin-api-test-fixtures-13.0.0.3026-javadoc.jar (test utilities)

The existing logic mv *javadoc.jar javadoc.zip failed with "No such file or directory" when multiple files matched the pattern.

Solution

Enhanced the javadoc extraction step with intelligent file selection:

• Single javadoc file: Uses original simple logic (preserves backward compatibility)
• Multiple javadoc files: Automatically filters out test/fixture variants and selects main javadoc
• No clear main javadoc: Fails with clear error message directing users to Engineering Experience team

Tested scenarios: 7/7 unit tests pass, covering single javadoc, multiple with test/fixture variants, edge cases, and error conditions. As there are no unit tests in the repo, I kept them locally