fix bot comment on azure-ai-transcription sdk apiview (#48889)

* fix bot comment on apiview

* Fix lint: drop @ServiceMethod on convenience transcribeWithResponse(TranscriptionOptions) overload

The Checkstyle ServiceClientCheck requires sync methods annotated with @ServiceMethod to take Context/RequestOptions/RequestContext. The convenience overload only takes TranscriptionOptions, so the annotation is removed. Also drops unused ClientLogger imports/fields and fixes javadoc rendering in the customization.

* update changelog

Author: amber-yujueWang

sdk/transcription/azure-ai-speech-transcription/CHANGELOG.md

@@ -1,15 +1,12 @@
 # Release History
 
-## 1.0.0-beta.3 (Unreleased)
-
-### Features Added
-
-### Breaking Changes
-
-### Bugs Fixed
+## 1.0.0-beta.3 (2026-04-22)
 
 ### Other Changes
 
+- Updated package metadata (display name and description) to align with Azure SDK guidelines.
+- Internal cleanup and lint fixes. No public API changes.
+
 ## 1.0.0-beta.2 (2026-02-05)
 
 ### Bugs Fixed

sdk/transcription/azure-ai-speech-transcription/customization/src/main/java/SpeechTranscriptionCustomization.java

@@ -313,7 +313,7 @@ private void customizeTranscriptionClient(PackageCustomization packageCustomizat
                     = clazz.addMethod("transcribe", Modifier.Keyword.PUBLIC)
                         .addParameter("TranscriptionOptions", "options")
                         .setType("TranscriptionResult");
-                transcribeMethod.setJavadocComment("/**\n"
+                transcribeMethod.setJavadocComment("\n"
                     + " * Transcribes the provided audio stream with the specified options.\n" + " *\n"
                     + " * @param options the transcription options including audio file details or audio URL\n"
                     + " * @throws IllegalArgumentException thrown if parameters fail the validation.\n"
@@ -322,7 +322,7 @@ private void customizeTranscriptionClient(PackageCustomization packageCustomizat
                     + " * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.\n"
                     + " * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.\n"
                     + " * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.\n"
-                    + " * @return the result of the transcribe operation.\n" + " */");
+                    + " * @return the result of the transcribe operation.\n" + " ");
                 com.github.javaparser.ast.expr.NormalAnnotationExpr transcribeServiceMethodAnnotation
                     = new com.github.javaparser.ast.expr.NormalAnnotationExpr();
                 transcribeServiceMethodAnnotation.setName("ServiceMethod");
@@ -338,7 +338,7 @@ private void customizeTranscriptionClient(PackageCustomization packageCustomizat
                     = clazz.addMethod("transcribeWithResponse", Modifier.Keyword.PUBLIC)
                         .addParameter("TranscriptionOptions", "options")
                         .setType("Response<TranscriptionResult>");
-                transcribeWithResponseMethod.setJavadocComment("/**\n"
+                transcribeWithResponseMethod.setJavadocComment("\n"
                     + " * Transcribes the provided audio stream with the specified options.\n" + " *\n"
                     + " * @param options the transcription options including audio file details or audio URL\n"
                     + " * @throws IllegalArgumentException thrown if parameters fail the validation.\n"
@@ -347,12 +347,10 @@ private void customizeTranscriptionClient(PackageCustomization packageCustomizat
                     + " * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.\n"
                     + " * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.\n"
                     + " * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.\n"
-                    + " * @return the response containing the result of the transcribe operation.\n" + " */");
-                com.github.javaparser.ast.expr.NormalAnnotationExpr serviceMethodAnnotation
-                    = new com.github.javaparser.ast.expr.NormalAnnotationExpr();
-                serviceMethodAnnotation.setName("ServiceMethod");
-                serviceMethodAnnotation.addPair("returns", "ReturnType.SINGLE");
-                transcribeWithResponseMethod.addAnnotation(serviceMethodAnnotation);
+                    + " * @return the response containing the result of the transcribe operation.\n" + " ");
+                // Note: intentionally NOT adding @ServiceMethod here. The Checkstyle ServiceClientCheck
+                // requires sync methods annotated with @ServiceMethod to take Context/RequestOptions/RequestContext,
+                // but we want to keep the simple public signature transcribeWithResponse(TranscriptionOptions).
                 transcribeWithResponseMethod
                     .setBody(parseBlock("{ TranscriptionContent requestContent = new TranscriptionContent(options); "
                         + "if (options.getFileDetails() != null) { requestContent.setAudio(options.getFileDetails()); } "
@@ -396,7 +394,7 @@ private void customizeTranscriptionAsyncClient(PackageCustomization packageCusto
                     = clazz.addMethod("transcribe", Modifier.Keyword.PUBLIC)
                         .addParameter("TranscriptionOptions", "options")
                         .setType("Mono<TranscriptionResult>");
-                transcribeMethod.setJavadocComment("/**\n"
+                transcribeMethod.setJavadocComment("\n"
                     + " * Transcribes the provided audio stream with the specified options.\n" + " *\n"
                     + " * @param options the transcription options including audio file details or audio URL\n"
                     + " * @throws IllegalArgumentException thrown if parameters fail the validation.\n"
@@ -406,7 +404,7 @@ private void customizeTranscriptionAsyncClient(PackageCustomization packageCusto
                     + " * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.\n"
                     + " * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.\n"
                     + " * @return the result of the transcribe operation on successful completion of {@link Mono}.\n"
-                    + " */");
+                    + " ");
                 com.github.javaparser.ast.expr.NormalAnnotationExpr transcribeServiceMethodAnnotation
                     = new com.github.javaparser.ast.expr.NormalAnnotationExpr();
                 transcribeServiceMethodAnnotation.setName("ServiceMethod");
@@ -422,7 +420,7 @@ private void customizeTranscriptionAsyncClient(PackageCustomization packageCusto
                     = clazz.addMethod("transcribeWithResponse", Modifier.Keyword.PUBLIC)
                         .addParameter("TranscriptionOptions", "options")
                         .setType("Mono<Response<TranscriptionResult>>");
-                transcribeWithResponseMethod.setJavadocComment("/**\n"
+                transcribeWithResponseMethod.setJavadocComment("\n"
                     + " * Transcribes the provided audio stream with the specified options.\n" + " *\n"
                     + " * @param options the transcription options including audio file details or audio URL\n"
                     + " * @throws IllegalArgumentException thrown if parameters fail the validation.\n"
@@ -432,7 +430,7 @@ private void customizeTranscriptionAsyncClient(PackageCustomization packageCusto
                     + " * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.\n"
                     + " * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.\n"
                     + " * @return the response containing the result of the transcribe operation on successful completion of {@link Mono}.\n"
-                    + " */");
+                    + " ");
                 com.github.javaparser.ast.expr.NormalAnnotationExpr serviceMethodAnnotation
                     = new com.github.javaparser.ast.expr.NormalAnnotationExpr();
                 serviceMethodAnnotation.setName("ServiceMethod");

sdk/transcription/azure-ai-speech-transcription/pom.xml

@@ -17,8 +17,8 @@ Code generated by Microsoft (R) TypeSpec Code Generator.
   <version>1.0.0-beta.3</version> <!-- {x-version-update;com.azure:azure-ai-speech-transcription;current} -->
   <packaging>jar</packaging>
 
-  <name>Microsoft Azure SDK for Transcription</name>
-  <description>This package contains Microsoft Azure Transcription client library.</description>
+  <name>Microsoft Azure client library for Transcription</name>
+  <description>This package contains the Microsoft Azure Transcription client library.</description>
   <url>https://github.com/Azure/azure-sdk-for-java</url>
 
   <licenses>

sdk/transcription/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/TranscriptionAsyncClient.java

@@ -21,7 +21,6 @@
 import com.azure.core.http.rest.SimpleResponse;
 import com.azure.core.util.BinaryData;
 import com.azure.core.util.FluxUtil;
-import com.azure.core.util.logging.ClientLogger;
 import reactor.core.publisher.Mono;
 
 /**
@@ -30,8 +29,6 @@
 @ServiceClient(builder = TranscriptionClientBuilder.class, isAsync = true)
 public final class TranscriptionAsyncClient {
 
-    private static final ClientLogger LOGGER = new ClientLogger(TranscriptionAsyncClient.class);
-
     @Generated
     private final TranscriptionClientImpl serviceClient;
 
@@ -158,6 +155,7 @@ public Mono<TranscriptionResult> transcribe(TranscriptionOptions options) {
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the response containing the result of the transcribe operation on successful completion of {@link Mono}.
      */
+    @ServiceMethod(returns = ReturnType.SINGLE)
     public Mono<Response<TranscriptionResult>> transcribeWithResponse(TranscriptionOptions options) {
         TranscriptionContent requestContent = new TranscriptionContent(options);
         if (options.getFileDetails() != null) {

sdk/transcription/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/TranscriptionClient.java

@@ -20,16 +20,13 @@
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.SimpleResponse;
 import com.azure.core.util.BinaryData;
-import com.azure.core.util.logging.ClientLogger;
 
 /**
  * Initializes a new instance of the synchronous TranscriptionClient type.
  */
 @ServiceClient(builder = TranscriptionClientBuilder.class)
 public final class TranscriptionClient {
 
-    private static final ClientLogger LOGGER = new ClientLogger(TranscriptionClient.class);
-
     @Generated
     private final TranscriptionClientImpl serviceClient;