@azure-tools/typespec-azure-resource-manager 0.70.0-dev.1 → 0.70.0-dev.3

package/lib/interfaces.tsp

@@ -13,7 +13,7 @@ namespace Azure.ResourceManager;
  */
 interface Operations {
   /**
-   * @dev List the operations for the provider.
+   * List the operations for the provider.
    */
   @tag("Operations")
   @autoRoute
@@ -146,9 +146,10 @@ interface ResourceCollectionOperations<
  */
 interface ResourceListBySubscription<Resource extends Foundations.SimpleResource> {
   /**
-   * @dev List resources by subscription.
+   * List resources by subscription.
    * @template Resource The ArmResource to list.
    */
+  @doc("List {name} resources by subscription ID", Resource)
   listBySubscription is ArmListBySubscription<Resource>;
 }
 
@@ -166,7 +167,7 @@ interface ResourceListByParent<
   ParentFriendlyName extends valueof string = ""
 > {
   /**
-   * @dev List resources by parent.
+   * List resources by parent.
    * @template Resource The ArmResource to list.
    * @template BaseParameters The http parameters that are part of the request
    * @template ParentName The name of the parent resource
@@ -186,10 +187,11 @@ interface ResourceRead<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Retrieve a resource.
+   * Retrieve a resource.
    * @template Resource The ArmResource to retrieve.
    * @template BaseParameters The http parameters that are part of the request
    */
+  @doc("Get a {name}", Resource)
   get is ArmResourceRead<Resource, BaseParameters>;
 }
 
@@ -203,10 +205,11 @@ interface ResourceCreateSync<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Create or update a resource using the synchronous call pattern.
+   * Create or update a resource using the synchronous call pattern.
    * @template Resource The ArmResource to create or update.
    * @template BaseParameters The http parameters that are part of the request
    */
+  @doc("Create a {name}", Resource)
   createOrUpdate is ArmResourceCreateOrReplaceSync<Resource, BaseParameters>;
 }
 
@@ -220,15 +223,16 @@ interface ResourceCreateAsync<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Create or update a resource using the asynchronous call pattern.
+   * Create or update a resource using the asynchronous call pattern.
    * @template Resource The ArmResource to create or update.
    * @template BaseParameters The http parameters that are part of the request
    */
+  @doc("Create a {name}", Resource)
   createOrUpdate is ArmResourceCreateOrUpdateAsync<Resource, BaseParameters>;
 }
 
 /**
- * @dev A composite interface for resources that include a long-running delete operation.
+ * A composite interface for resources that include a long-running delete operation.
  *      DEPRECATED: Use ResourceDeleteWithoutOkAsync instead
  * @template Resource The ArmResource that provides these operations
  * @template BaseParameters The http parameters that are part of the request
@@ -240,15 +244,17 @@ interface ResourceDeleteAsync<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Delete a resource using the asynchronous call pattern.
+   * Delete a resource using the asynchronous call pattern.
    * @template Resource The ArmResource to delete.
    * @template BaseParameters The http parameters that are part of the request
    */
+  @doc("Delete a {name}", Resource)
   delete is ArmResourceDeleteAsync<Resource, BaseParameters>;
 }
 
 /**
- * @dev A composite interface for resources that include a synchronous delete operation.
+ * A composite interface for resources that include a long-running delete operation
+ * without returning a final OK response.
  * @template Resource The ArmResource that provides these operations
  * @template BaseParameters The http parameters that are part of the request
  */
@@ -258,10 +264,11 @@ interface ResourceDeleteWithoutOkAsync<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Delete a resource using the asynchronous call pattern.
+   * Delete a resource using the asynchronous call pattern.
    * @template Resource The ArmResource to delete.
    * @template BaseParameters The http parameters that are part of the request
    */
+  @doc("Delete a {name}", Resource)
   delete is ArmResourceDeleteWithoutOkAsync<Resource, BaseParameters>;
 }
 
@@ -276,15 +283,16 @@ interface ResourceDeleteSync<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Delete a resource using the synchronous call pattern.
+   * Delete a resource using the synchronous call pattern.
    * @template Resource The ArmResource to delete.
    * @template BaseParameters The http parameters that are part of the request
    */
+  @doc("Delete a {name}", Resource)
   delete is ArmResourceDeleteSync<Resource, BaseParameters>;
 }
 
 /**
- * @dev A composite interface for resources that include a long-running update operation.
+ * A composite interface for resources that include a long-running update operation.
  * @template Resource The ArmResource that provides these operations
  * @template Properties RP-specific property bag for the resource
  * @template BaseParameters The http parameters that are part of the request
@@ -296,11 +304,12 @@ interface ResourceUpdateAsync<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Update a resource using the asynchronous call pattern.
+   * Update a resource using the asynchronous call pattern.
    * @template Resource The ArmResource to update.
    * @template Properties RP-specific property bag for the resource
    * @template BaseParameters The http parameters that are part of the request
    */
+  @doc("Update a {name}", Resource)
   update is ArmCustomPatchAsync<
     Resource,
     ResourceUpdateModel<Resource, Properties>,
@@ -321,13 +330,14 @@ interface ResourceUpdateSync<
   BaseParameters = DefaultBaseParameters<Resource>
 > {
   /**
-   * @dev Update a resource using the synchronous call pattern.
+   * Update a resource using the synchronous call pattern.
    * @template Resource The ArmResource to update.
    * @template Properties RP-specific property bag for the resource
    * @template BaseParameters The http parameters that are part of the request
    */
   #suppress "@typespec/http/deprecated-implicit-optionality" "Legacy"
   @patch(#{ implicitOptionality: true })
+  @doc("Update a {name}", Resource)
   update is ArmCustomPatchSync<Resource, ResourceUpdateModel<Resource, Properties>, BaseParameters>;
 }
 

package/lib/legacy-types/extension.tsp

@@ -215,7 +215,7 @@ interface ExtensionOperations<
   >(...TargetParameters, ...ExtensionInstanceParameters, ...Parameters): Response | ErrorType;
 
   /**
-   * @dev Get a resource
+   * Get a resource
    * @template Resource The resource being read
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response for a get operation.

package/lib/legacy-types/operations.tsp

@@ -246,7 +246,7 @@ interface RoutedOperations<
   >(...ParentParameters, ...ResourceTypeParameter, ...Parameters): Response | OverrideErrorType;
 
   /**
-   * @dev Get a resource
+   * Get a resource
    * @template Resource The resource being read
    * @template Parameters Optional. Additional parameters after the path parameters
    * @template Response Optional. The success response for a get operation.
@@ -434,17 +434,19 @@ interface RoutedOperations<
   ): Response | OverrideErrorType;
 }
 /**
- * @dev DEPRECATED: Use ProviderParameter instead. Get the provider namespace key-value pair
+ * DEPRECATED: Use ProviderParameter instead. Get the provider namespace key-value pair
  * @template Resource Optional.  The resource to get the provider namespace for.
  */
+@doc("")
 model Provider<Resource extends {} = TenantActionScope> {
   ...ProviderNamespace<Resource>;
 }
 
 /**
- * @dev Get the provider namespace key-value pair
+ * Get the provider namespace key-value pair
  * @template Resource The resource to get the provider namespace for.
  */
+@doc("")
 model ProviderParameter<Resource extends {}> {
   ...ProviderNamespace<Resource>;
 }
@@ -709,13 +711,14 @@ op ArmListSinglePageByParent<
 >;
 
 /**
- * @dev The base template for Azure Resource Manager PUT Operations.
+ * The base template for Azure Resource Manager PUT Operations.
  * @template HttpParameters The parameter object for the operation.
  * @template BodyParameter The body parameter
  * @template Response The response or union of responses for success.
  * @template ErrorResponse The error response.
  * @template OptionalRequestBody Optional. Indicates whether the request body is optional
  */
+@doc("")
 op CreateOperation<
   HttpParameters extends {},
   BodyParameter extends {} | void,
@@ -731,13 +734,14 @@ op CreateOperation<
 ): Response | ErrorResponse;
 
 /**
- * @dev The base template for Legacy Azure Resource Manager PATCH Operations.
+ * The base template for Legacy Azure Resource Manager PATCH Operations.
  * @template HttpParameters The parameter object for the operation.
  * @template BodyParameter The body parameter
  * @template Response The response or union of responses for success.
  * @template ErrorResponse The error response.
  * @template OptionalRequestBody Optional. Indicates whether the request body is optional
  */
+@doc("")
 op UpdateOperation<
   HttpParameters extends {},
   BodyParameter extends {} | void,

package/lib/legacy-types/private-endpoints.tsp

@@ -8,7 +8,7 @@ using Azure.ResourceManager.Foundations;
 using Rest;
 
 /**
- * @dev List the private endpoint connections over a resource
+ * List the private endpoint connections over a resource
  * @template ParentResource the parent resource of the PrivateEndpointConnection
  * @template Resource Optional. The PrivateEndpointConnection resource being listed
  * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -39,7 +39,7 @@ op ListSinglePageByParent<
 >;
 
 /**
- * @dev Synchronous PUT operation for a Private endpoint connection to a resource
+ * Synchronous PUT operation for a Private endpoint connection to a resource
  * @template ParentResource the parent resource of the PrivateEndpointConnection
  * @template Resource the PrivateEndpointConnection resource being created or updated
  * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -76,7 +76,7 @@ op CreateOrReplaceSync<
 >;
 
 /**
- * @dev A long-running resource CreateOrUpdate (PUT) for a PrivateEndpointConnection to a resource
+ * A long-running resource CreateOrUpdate (PUT) for a PrivateEndpointConnection to a resource
  * @template ParentResource the parent resource of the PrivateEndpointConnection
  * @template Resource the PrivateEndpointConnection resource being created or updated
  * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -161,7 +161,7 @@ op CustomPatchAsync<
 >;
 
 /**
- * @dev A resource update using a custom PATCH payload (synchronous) to update a PrivateEndpointConnection to a resource
+ * A resource update using a custom PATCH payload (synchronous) to update a PrivateEndpointConnection to a resource
  * @template ParentResource The parent resource of the PrivateEndpointConnection
  * @template Resource Optional. The PrivateEndpointConnection resource being patched
  * @template PatchModel The input model for the PATCH request

package/lib/models.tsp

@@ -340,7 +340,7 @@ model ResourceKindProperty<Type extends string = string> {
 model ResourceListResult<Resource extends Foundations.SimpleResource> is Azure.Core.Page<Resource>;
 
 /**
- * Paged response containing results
+ * Paged response containing custom result types.
  * @template Result The type of the values returned in the paged response
  */
 @doc("The custom response of a list operation.")

package/lib/operations.tsp

@@ -302,7 +302,7 @@ op ArmResourceCreateOrReplaceSync<
 >;
 
 /**
- * @dev A long-running resource CreateOrUpdate (PUT)
+ * A long-running resource CreateOrUpdate (PUT)
  * @template Resource the resource being created or replaced
  * @template BaseParameters Optional. Allows overriding the operation parameters
  * @template LroHeaders Optional.  Allows overriding the lro headers returned on resource create
@@ -311,6 +311,7 @@ op ArmResourceCreateOrReplaceSync<
  * @template Error Optional. The error response, if non-standard.
  * @template Provider Optional. The provider namespace model for the resource.
  */
+@doc("Create a {name}", Resource)
 @Private.enforceConstraint(Resource, Foundations.Resource)
 op ArmResourceCreateOrReplaceAsync<
   Resource extends Foundations.SimpleResource,
@@ -334,7 +335,7 @@ op ArmResourceCreateOrReplaceAsync<
 >;
 
 /**
- * @dev A long-running resource update that only allows updating resource tags (the minimum)
+ * A long-running resource update that only allows updating resource tags (the minimum)
  * @template Resource the resource being patched
  * @template Properties Optional. Exists for parallelism with ArmResourcePatch.
  * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -345,6 +346,7 @@ op ArmResourceCreateOrReplaceAsync<
 #suppress "@typespec/http/deprecated-implicit-optionality" "Legacy"
 @patch(#{ implicitOptionality: true })
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("Update a {name}", Resource)
 op ArmTagsPatchAsync<
   Resource extends Foundations.SimpleResource,
   Properties extends {} = TagsUpdateModel<Resource>,
@@ -369,7 +371,7 @@ op ArmTagsPatchAsync<
 >;
 
 /**
- * @dev A long-running resource update using the items from the resource marked with Lifecycle.Update visibility
+ * A long-running resource update using the items from the resource marked with Lifecycle.Update visibility
  * @template Resource the resource being patched
  * @template Properties The model type of the resource properties
  * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -380,6 +382,7 @@ op ArmTagsPatchAsync<
 #suppress "@typespec/http/deprecated-implicit-optionality" "Legacy"
 @patch(#{ implicitOptionality: true })
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("Update a {name}", Resource)
 op ArmResourcePatchAsync<
   Resource extends Foundations.SimpleResource,
   Properties extends TypeSpec.Reflection.Model,
@@ -443,7 +446,7 @@ op ArmCustomPatchAsync<
 >;
 
 /**
- * @dev A resource update that only allows updating resource tags (the minimum)
+ * A resource update that only allows updating resource tags (the minimum)
  * @template Resource the resource being patched
  * @template BaseParameters Optional. Allows overriding the operation parameters
  * @template Parameters Optional. Additional parameters after the path parameters
@@ -452,6 +455,7 @@ op ArmCustomPatchAsync<
 #suppress "@typespec/http/deprecated-implicit-optionality" "Legacy"
 @patch(#{ implicitOptionality: true })
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("Update a {name}", Resource)
 op ArmTagsPatchSync<
   Resource extends Foundations.SimpleResource,
   BaseParameters = DefaultBaseParameters<Resource>,
@@ -468,7 +472,7 @@ op ArmTagsPatchSync<
 >;
 
 /**
- * @dev A resource update using the items from the resource marked with Lifecycle.Update visibility
+ * A resource update using the items from the resource marked with Lifecycle.Update visibility
  * @template Resource the resource being patched
  * @template Properties The model type of the resource properties
  * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -478,6 +482,7 @@ op ArmTagsPatchSync<
 #suppress "@typespec/http/deprecated-implicit-optionality" "Legacy"
 @patch(#{ implicitOptionality: true })
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("Update a {name}", Resource)
 op ArmResourcePatchSync<
   Resource extends Foundations.SimpleResource,
   Properties extends TypeSpec.Reflection.Model,
@@ -525,7 +530,7 @@ op ArmCustomPatchSync<
 >;
 
 /**
- * @dev Delete a resource asynchronously
+ * Delete a resource asynchronously
  * @template Resource The resource being deleted
  * @template Response The response type for the operation
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
@@ -550,7 +555,7 @@ op ArmResourceDeleteAsyncBase<
   | Error;
 
 /**
- * @dev Delete a resource asynchronously.  DEPRECATED: Use ArmResourceDeleteWithoutOkAsync instead
+ * Delete a resource asynchronously.  DEPRECATED: Use ArmResourceDeleteWithoutOkAsync instead
  * @template Resource The resource being deleted
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
  * @template LroHeaders Optional. Allows overriding the headers in the Accepted response
@@ -561,6 +566,7 @@ op ArmResourceDeleteAsyncBase<
  */
 #deprecated "Use 'ArmResourceDeleteWithoutOkAsync' instead"
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("Delete a {name}", Resource)
 op ArmResourceDeleteAsync<
   Resource extends Foundations.SimpleResource,
   BaseParameters = DefaultBaseParameters<Resource>,
@@ -576,7 +582,7 @@ op ArmResourceDeleteAsync<
 > is ArmResourceDeleteAsyncBase<Resource, Response, BaseParameters, Parameters, Error, Provider>;
 
 /**
- * @dev Delete a resource asynchronously
+ * Delete a resource asynchronously
  * @template Resource The resource being deleted
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
  * @template LroHeaders Optional. Allows overriding the headers returned in the Accepted response
@@ -586,6 +592,7 @@ op ArmResourceDeleteAsync<
  * @template Provider Optional. The provider namespace model for the resource.
  */
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("Delete a {name}", Resource)
 op ArmResourceDeleteWithoutOkAsync<
   Resource extends Foundations.SimpleResource,
   BaseParameters = DefaultBaseParameters<Resource>,
@@ -656,7 +663,7 @@ op ArmResourceActionAsyncBase<
 ): Response | Error;
 
 /**
- * @dev A long-running resource action.
+ * A long-running resource action.
  * @template Resource The resource being acted upon
  * @template Request The request model for the action
  * @template Response The response model for the action
@@ -669,6 +676,7 @@ op ArmResourceActionAsyncBase<
  */
 @returnsDoc("Azure operation completed successfully.")
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("")
 op ArmResourceActionAsync<
   Resource extends Foundations.SimpleResource,
   Request,
@@ -696,7 +704,7 @@ op ArmResourceActionAsync<
 >;
 
 /**
- * @dev The *standard*  long-running resource action.
+ * The *standard*  long-running resource action.
  * @template Resource The resource being acted upon
  * @template Request The request model for the action
  * @template Response The response model for the action, returned after polling the long-running operation
@@ -709,6 +717,7 @@ op ArmResourceActionAsync<
  */
 @returnsDoc("Azure operation completed successfully.")
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("")
 op ActionAsync<
   Resource extends Foundations.SimpleResource,
   Request,
@@ -770,7 +779,7 @@ op ArmResourceActionSync<
 ): Response | Error;
 
 /**
- * @dev A long-running resource action that returns no content. DEPRECATED: Use 'ArmResourceActionNoResponseContentAsync' instead
+ * A long-running resource action that returns no content. DEPRECATED: Use 'ArmResourceActionNoResponseContentAsync' instead
  * @template Resource The resource being acted upon
  * @template Request The request model for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
@@ -781,6 +790,7 @@ op ArmResourceActionSync<
  * @template Provider Optional. The provider namespace model for the resource.
  */
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("")
 op ArmResourceActionNoContentAsync<
   Resource extends Foundations.SimpleResource,
   Request extends TypeSpec.Reflection.Model | void,
@@ -794,9 +804,8 @@ op ArmResourceActionNoContentAsync<
 > is ArmResourceActionAsyncBase<
   Resource,
   Request,
-
-    | ArmAcceptedLroResponse<"Resource operation accepted.", LroHeaders>
-    | ArmNoContentResponse<"Action completed successfully.">,
+  | ArmAcceptedLroResponse<"Resource operation accepted.", LroHeaders>
+  | ArmNoContentResponse<"Action completed successfully.">,
   BaseParameters,
   Parameters,
   Error,
@@ -805,7 +814,7 @@ op ArmResourceActionNoContentAsync<
 >;
 
 /**
- * @dev A long-running resource action that returns no content.
+ * A long-running resource action that returns no content.
  * @template Resource The resource being acted upon
  * @template Request The request model for the action
  * @template BaseParameters Optional. Allows overriding the parameters for the operation
@@ -816,6 +825,7 @@ op ArmResourceActionNoContentAsync<
  * @template Provider Optional. The provider namespace model for the resource.
  */
 @Private.enforceConstraint(Resource, Foundations.Resource)
+@doc("")
 op ArmResourceActionNoResponseContentAsync<
   Resource extends Foundations.SimpleResource,
   Request,
@@ -873,7 +883,7 @@ op ArmResourceActionNoContentSync<
 ): ArmNoContentResponse<"Action completed successfully."> | Error;
 
 /**
- * @dev Adds check global name availability operation, normally used if
+ * Adds check global name availability operation, normally used if
  * a resource name must be globally unique (for example, if the resource
  * exposes and endpoint that uses the resource name in the url)
  * @template Request the availability request, defaults to the standard request, containing name and resource type
@@ -893,7 +903,7 @@ op checkGlobalNameAvailability<
 >;
 
 /**
- * @dev Adds check location-specific name availability operation, normally used if
+ * Adds check location-specific name availability operation, normally used if
  * a resource name must be globally unique (for example, if the resource
  * exposes and endpoint that uses the resource name in the url)
  * @template Request the availability request, defaults to the standard request, containing name and resource type
@@ -913,7 +923,7 @@ op checkLocalNameAvailability<
 >;
 
 /**
- * @dev A provider action performed over a tenant
+ * A provider action performed over a tenant
  * @template Request The request model for the action
  * @template Response The response type for the action
  * @template Scope The scope of the action (SubscriptionActionScope, TenantActionScope, or ExtensionResourceActionScope)
@@ -925,6 +935,7 @@ op checkLocalNameAvailability<
 @action
 @armResourceCollectionAction
 @Private.armUpdateProviderNamespace
+@doc("")
 op ArmProviderActionSync<
   Request extends {} | unknown | void = void,
   Response extends {} | unknown | void = void,
@@ -943,7 +954,7 @@ op ArmProviderActionSync<
 ): Response | Error;
 
 /**
- * @dev A long-running provider action.
+ * A long-running provider action.
  * @template Request The request model for the action
  * @template Response The response type for the action
  * @template Scope The scope of the action (SubscriptionActionScope, TenantActionScope, or ExtensionResourceActionScope)
@@ -956,6 +967,7 @@ op ArmProviderActionSync<
 @action
 @armResourceCollectionAction
 @Private.armUpdateProviderNamespace
+@doc("")
 op ArmProviderActionAsync<
   Request extends {} | unknown | void = void,
   Response extends TypeSpec.Reflection.Model | unknown | void = void,

package/lib/private-endpoints.tsp

@@ -56,7 +56,7 @@ interface PrivateEndpoints<
   ResourceParameter extends {} = CommonTypes.PrivateEndpointConnectionParameter
 > {
   /**
-   * @dev List the private endpoint connections over a resource
+   * List the private endpoint connections over a resource
    * @template ParentResource the parent resource of the PrivateEndpointConnection
    * @template Resource Optional. The PrivateEndpointConnection resource being listed
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -90,7 +90,7 @@ interface PrivateEndpoints<
   >;
 
   /**
-   * @dev GET the a private endpoint connection for a particular resource
+   * GET the a private endpoint connection for a particular resource
    * @template ParentResource the parent resource of the PrivateEndpointConnection
    * @template Resource the PrivateEndpointConnection resource being read
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -120,7 +120,7 @@ interface PrivateEndpoints<
   >;
 
   /**
-   * @dev A long-running resource CreateOrUpdate (PUT) for a PrivateEndpointConnection to a resource
+   * A long-running resource CreateOrUpdate (PUT) for a PrivateEndpointConnection to a resource
    * @template ParentResource the parent resource of the PrivateEndpointConnection
    * @template Resource the PrivateEndpointConnection resource being created or updated
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -158,7 +158,7 @@ interface PrivateEndpoints<
   >;
 
   /**
-   * @dev Synchronous PUT operation for a Private endpoint connection to a resource
+   * Synchronous PUT operation for a Private endpoint connection to a resource
    * @template ParentResource the parent resource of the PrivateEndpointConnection
    * @template Resource the PrivateEndpointConnection resource being created or updated
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -192,7 +192,7 @@ interface PrivateEndpoints<
   >;
 
   /**
-   * @dev A long-running resource CreateOrUpdate (PUT) for a PrivateEndpointConnection to a resource
+   * A long-running resource CreateOrUpdate (PUT) for a PrivateEndpointConnection to a resource
    * @template ParentResource the parent resource of the PrivateEndpointConnection
    * @template Resource the PrivateEndpointConnection resource being created or updated
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -272,7 +272,7 @@ interface PrivateEndpoints<
   >;
 
   /**
-   * @dev A resource update using a custom PATCH payload (synchronous) to update a PrivateEndpointConnection to a resource
+   * A resource update using a custom PATCH payload (synchronous) to update a PrivateEndpointConnection to a resource
    * @template ParentResource The parent resource of the PrivateEndpointConnection
    * @template Resource Optional. The PrivateEndpointConnection resource being patched
    * @template PatchModel The input model for the PATCH request
@@ -306,7 +306,7 @@ interface PrivateEndpoints<
   >;
 
   /**
-   * @dev Delete a PrivateEndpointConnection to a resource asynchronously
+   * Delete a PrivateEndpointConnection to a resource asynchronously
    * @template ParentResource The parent resource of the PrivateEndpointConnection
    * @template Resource Optional. The PrivateEndpointConnection resource being deleted
    * @template BaseParameters Optional. Allows overriding the parameters for the operation
@@ -338,7 +338,7 @@ interface PrivateEndpoints<
   ): Response | Error;
 
   /**
-   * @dev Delete a PrivateEndpointConnection to a resource synchronously
+   * Delete a PrivateEndpointConnection to a resource synchronously
    * @template ParentResource The parent resource of the PrivateEndpointConnection
    * @template Resource The PrivateEndpointConnection resource being deleted
    * @template BaseParameters Optional. Allows overriding the parameters for the operation
@@ -367,7 +367,7 @@ interface PrivateEndpoints<
   ): Response | Error;
 
   /**
-   * @dev Delete a PrivateEndpointConnection to a resource asynchronously
+   * Delete a PrivateEndpointConnection to a resource asynchronously
    * @template ParentResource The parent resource of the PrivateEndpointConnection
    * @template Response The response type for the operation
    * @template Resource Optional. The PrivateEndpointConnection resource being deleted

package/lib/private-links.tsp

@@ -57,7 +57,7 @@ interface PrivateLinks<
   ResourceParameter extends {} = CommonTypes.PrivateLinkResourceParameter
 > {
   /**
-   * @dev List the private links to a resource
+   * List the private links to a resource
    * @template ParentResource the parent resource of the PrivateLink
    * @template Resource Optional. The PrivateLink resource being listed
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -91,7 +91,7 @@ interface PrivateLinks<
   >;
 
   /**
-   * @dev List the private links to a resource - this should only be used for legacy operations
+   * List the private links to a resource - this should only be used for legacy operations
    * @template ParentResource the parent resource of the PrivateLink
    * @template Resource Optional. The PrivateLink resource being listed
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -125,7 +125,7 @@ interface PrivateLinks<
   >;
 
   /**
-   * @dev GET the a private link to a particular resource
+   * GET the a private link to a particular resource
    * @template ParentResource the parent resource of the PrivateLink
    * @template Resource the PrivateLink resource being read
    * @template BaseParameters Optional. Allows overriding the operation parameters