Use doclint -missing to handle Java 21 Javadoc errors instead of setting different Java versions in CI (#42112)

Author: alzimmermsft

eng/pipelines/templates/jobs/ci.tests.yml

@@ -136,7 +136,6 @@ jobs:
       - template: /eng/pipelines/templates/steps/run-and-validate-linting.yml
         parameters:
           JavaBuildVersion: $(JavaTestVersion)
-          JavadocSafeJavaBuildVersion: $(JavadocSafeJavaBuildVersion)
           AdditionalLintingOptions: ${{ parameters.AdditionalLintingOptions }}
           BuildParallelization: ${{ parameters.BuildParallelization }}
           ContinueOnError: true

eng/pipelines/templates/jobs/ci.yml

@@ -49,9 +49,6 @@ parameters:
   - name: JavaBuildVersion
     type: string
     default: $(JavaBuildVersion)
-  - name: JavadocSafeJavaBuildVersion
-    type: string
-    default: $(JavadocSafeJavaBuildVersion)
   - name: IgnoreVerifyTypeSpecCodeGenerationError
     type: boolean
     default: false
@@ -163,14 +160,14 @@ jobs:
         displayName: 'pip install markdown2 and BeautifulSoup4'
 
       - task: Maven@4
-        displayName: 'Build and Package, JDK Version: ${{ parameters.JavadocSafeJavaBuildVersion }}'
+        displayName: 'Build and Package, JDK Version: ${{ parameters.JavaBuildVersion }}'
         inputs:
           mavenPomFile: pom.xml
           goals: 'deploy'
           options: '$(DefaultOptions) -T ${{parameters.BuildParallelization}} -DskipTests -Dgenerate-overview -Dspotbugs.skip=true -Dcheckstyle.skip=true -Drevapi.skip=true -Dspotless.apply.skip=true -pl $(ProjectList) -am -DaltDeploymentRepository=id::default::file://$(System.DefaultWorkingDirectory)/build' # We include template-module so we ensure it always builds in CI
           mavenOptions: '$(MemoryOptions) $(LoggingOptions)'
           javaHomeOption: 'JDKVersion'
-          jdkVersionOption: ${{ parameters.JavadocSafeJavaBuildVersion }} # TODO (vcolin7): Change to ${{ parameters.JavaBuildVersion }} once Javadoc migration to Java 21 is complete.
+          jdkVersionOption: ${{ parameters.JavaBuildVersion }}
           jdkArchitectureOption: 'x64'
           publishJUnitResults: false
 
@@ -368,7 +365,6 @@ jobs:
       - template: /eng/pipelines/templates/steps/run-and-validate-linting.yml
         parameters:
           JavaBuildVersion: ${{ parameters.JavaBuildVersion }}
-          JavadocSafeJavaBuildVersion: ${{ parameters.JavadocSafeJavaBuildVersion }}
           AdditionalLintingOptions: ${{ parameters.AdditionalLintingOptions }}
           BuildParallelization: ${{ parameters.BuildParallelization }}
           RunLinting: true

eng/pipelines/templates/stages/archetype-sdk-client-patch.yml

@@ -17,9 +17,6 @@ parameters:
 - name: JavaBuildVersion
   type: string
   default: $(JavaBuildVersion)
-- name: JavadocSafeJavaBuildVersion
-  type: string
-  default: $(JavadocSafeJavaBuildVersion)
 - name: TestPipeline
   type: boolean
   default: false
@@ -126,14 +123,14 @@ extends:
                 JdkVersion: ${{ parameters.JavaBuildVersion }}
 
             - task: Maven@4
-              displayName: 'Build From Source and Package, JDK Version: ${{ parameters.JavadocSafeJavaBuildVersion }}'
+              displayName: 'Build From Source and Package, JDK Version: ${{ parameters.JavaBuildVersion }}'
               inputs:
                 mavenPomFile: ClientFromSourcePom.xml
                 goals: 'deploy'
                 options: '$(DefaultOptions) -T ${{parameters.BuildParallelization}} -DskipTests -Dgenerate-overview -Dspotbugs.skip=true -Dcheckstyle.skip=true -Drevapi.skip=true -Dspotless.apply.skip=true -pl $(ProjectList) -am -DaltDeploymentRepository=id::default::file://$(System.DefaultWorkingDirectory)/build' # We include template-module, so we ensure it always builds in CI.
                 mavenOptions: '$(MemoryOptions) $(LoggingOptions)'
                 javaHomeOption: 'JDKVersion'
-                jdkVersionOption: ${{ parameters.JavadocSafeJavaBuildVersion }}
+                jdkVersionOption: ${{ parameters.JavaBuildVersion }}
                 jdkArchitectureOption: 'x64'
                 publishJUnitResults: false
 

eng/pipelines/templates/stages/archetype-sdk-client.yml

@@ -46,9 +46,6 @@ parameters:
   - name: JavaBuildVersion
     type: string
     default: $(JavaBuildVersion)
-  - name: JavadocSafeJavaBuildVersion
-    type: string
-    default: $(JavadocSafeJavaBuildVersion)
   - name: LiveTestStages
     type: stageList
     default: []

eng/pipelines/templates/steps/run-and-validate-linting.yml

@@ -2,9 +2,6 @@ parameters:
   - name: JavaBuildVersion
     type: string
     default: $(JavaBuildVersion)
-  - name: JavadocSafeJavaBuildVersion
-    type: string
-    default: $(JavadocSafeJavaBuildVersion)
   - name: AdditionalLintingOptions
     type: string
     default: ''
@@ -87,7 +84,7 @@ steps:
       options: '$(DefaultOptions) --no-transfer-progress ${{ parameters.AdditionalLintingOptions }} -pl $(ProjectList)'
       mavenOptions: '$(MemoryOptions)'
       javaHomeOption: 'JDKVersion'
-      jdkVersionOption: ${{ parameters.JavadocSafeJavaBuildVersion }} # TODO (vcolin7): Change to ${{ parameters.JavaBuildVersion }} once Javadoc migration to Java 21 is complete. See: https://github.com/Azure/azure-sdk-for-java/issues/38267.
+      jdkVersionOption: ${{ parameters.JavaBuildVersion }}
       jdkArchitectureOption: 'x64'
       publishJUnitResults: false
       ${{ if ne(parameters.SDKType, 'client') }}:

eng/pipelines/templates/variables/globals.yml

@@ -2,8 +2,6 @@ variables:
   DocWardenVersion: '0.7.2'
   # This is the default Java build version. It's the version used to build the shipping libraries, Spotbugs etc.
   JavaBuildVersion: '1.21'
-  # This is the highest Java version we can write all our Javadocs with. Libraries that support a higher version can override this value in their CI templates.
-  JavadocSafeJavaBuildVersion: '1.17' # TODO (vcolin7): Remove and use JavaBuildVersion in templates once Javadoc migration to Java 21 is complete. See: https://github.com/Azure/azure-sdk-for-java/issues/38267.
   # This is the highest LTS Java version we use to build the Cosmos Spark connectors and libraries baselined on Java 7.
   FallbackJavaBuildVersion: '1.17'
   # This is the default Java test version. It's the version used when running tests.

sdk/advisor/azure-resourcemanager-advisor/pom.xml

@@ -39,6 +39,7 @@
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <jacoco.skip>true</jacoco.skip>
+    <doclintMissingInclusion>-</doclintMissingInclusion>
   </properties>
   <dependencies>
     <dependency>

sdk/agrifood/azure-resourcemanager-agrifood/pom.xml

@@ -39,6 +39,7 @@
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <jacoco.skip>true</jacoco.skip>
+    <doclintMissingInclusion>-</doclintMissingInclusion>
   </properties>
   <dependencies>
     <dependency>

sdk/alertsmanagement/azure-resourcemanager-alertsmanagement/pom.xml

@@ -39,6 +39,7 @@
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <jacoco.skip>true</jacoco.skip>
+    <doclintMissingInclusion>-</doclintMissingInclusion>
   </properties>
   <dependencies>
     <dependency>

sdk/appconfiguration/azure-data-appconfiguration-perf/src/main/java/com/azure/data/appconfiguration/perf/core/ServiceTest.java

@@ -13,19 +13,27 @@
 
 /**
  * Base class for Azure App Configuration performance tests.
+ *
+ * @param <TOptions> The type of stress options.
  */
 public abstract class ServiceTest<TOptions extends PerfStressOptions> extends PerfStressTest<TOptions> {
     private static final String CONFIGURATION_ERROR
         = "Configuration %s must be set in either environment variables " + "or system properties.%n";
 
+    /**
+     * The synchronous configuration client.
+     */
     protected final ConfigurationClient configurationClient;
+
+    /**
+     * The asynchronous configuration client.
+     */
     protected final ConfigurationAsyncClient configurationAsyncClient;
 
     /**
      * The base class for Azure App Configuration tests.
      *
      * @param options the configurable options for performing perf testing on this class.
-     *
      * @throws RuntimeException if "AZURE_APPCONFIG_CONNECTION_STRING" is null or empty.
      */
     public ServiceTest(TOptions options) {