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

package/README.md

@@ -117,7 +117,9 @@ the version of the Azure Resource Manager common-types to use for refs in emitte
 
 #### `@armLibraryNamespace`
 
-`@armLibraryNamespace` designates a namespace as containign Azure Resource Manager Provider information.
+`@armLibraryNamespace` designates a namespace as containing Azure Resource Manager Provider information.
+This is used for library namespaces that define reusable ARM resource types that can be shared
+across multiple provider specifications.
 
 ```typespec
 @Azure.ResourceManager.armLibraryNamespace
@@ -171,8 +173,9 @@ namespace Microsoft.ContosoService;
 
 #### `@armProviderNameValue`
 
-`@armResourceType` sets the value fo the decorated string
-property to the type of the Azure Resource Manager resource.
+`@armProviderNameValue` sets the provider namespace value on operations.
+It is used internally to inject the correct provider namespace path segment
+for resource operations in auto-generated routes.
 
 ```typespec
 @Azure.ResourceManager.armProviderNameValue
@@ -188,6 +191,11 @@ None
 
 #### `@armResourceAction`
 
+Marks the operation as a custom action on a specific Azure Resource Manager resource type.
+This decorator associates a POST action operation with its resource,
+identifying the semantics of the operation as a resource action over a specific resource for documentation,
+resource validation, and use by downstream emitters.
+
 ```typespec
 @Azure.ResourceManager.armResourceAction(resourceModel: Model, resourceName?: valueof string)
 ```
@@ -224,7 +232,9 @@ Marks the operation as being a check existence (HEAD) operation
 
 #### `@armResourceCollectionAction`
 
-Marks the operation as being a collection action
+Marks the operation as being a collection action that is not associated with a specific resource instance.
+Collection actions are operations that act on a resource collection rather than a single resource,
+such as `checkNameAvailability` or provider-level actions.
 
 ```typespec
 @Azure.ResourceManager.armResourceCollectionAction
@@ -240,6 +250,10 @@ None
 
 #### `@armResourceCreateOrUpdate`
 
+Marks the operation as a create or update (PUT) operation for a specific Azure Resource Manager resource type.
+This decorator identifies the semantics of the operation as a CreateOrReplace lifecycle operation over a particular resource,
+for use in documentation, resource validation, and downstream emitters.
+
 ```typespec
 @Azure.ResourceManager.armResourceCreateOrUpdate(resourceModel: Model, resourceName?: valueof string)
 ```
@@ -257,6 +271,10 @@ None
 
 #### `@armResourceDelete`
 
+Marks the operation as a delete (DELETE) operation for a specific Azure Resource Manager resource type.
+This decorator identifies the operation as a Delete lifecycle operation over the resource for us in documentation,
+resource validation, and downstream emitters.
+
 ```typespec
 @Azure.ResourceManager.armResourceDelete(resourceModel: Model, resourceName?: valueof string)
 ```
@@ -274,6 +292,10 @@ None
 
 #### `@armResourceList`
 
+Marks the operation as a list (GET collection) operation for a specific Azure Resource Manager resource type.
+This decorator identifies the semantics of the operation as a collection list operation over a resource type and a particular scope for documentation,
+resource validation, and downstream emitters.
+
 ```typespec
 @Azure.ResourceManager.armResourceList(resourceModel: Model, resourceName?: valueof string)
 ```
@@ -325,6 +347,10 @@ individually tagged
 
 #### `@armResourceRead`
 
+Marks the operation as a read (GET) operation for a specific Azure Resource Manager resource type.
+This decorator identifies the semantics of the operation as a Read lifecycle operation over a particular resource,
+for use in documentation, resource validation, and downstream emitters.
+
 ```typespec
 @Azure.ResourceManager.armResourceRead(resourceModel: Model, resourceName?: valueof string)
 ```
@@ -342,6 +368,10 @@ individually tagged
 
 #### `@armResourceUpdate`
 
+Marks the operation as an update (PATCH) operation for a specific Azure Resource Manager resource type.
+This decorator identifies the operation as an Update lifecycle operation over the resource for use in documentation,
+resource validation, and downstream emitters.
+
 ```typespec
 @Azure.ResourceManager.armResourceUpdate(resourceModel: Model, resourceName?: valueof string)
 ```
@@ -360,7 +390,8 @@ individually tagged
 #### `@armVirtualResource`
 
 This decorator is used on Azure Resource Manager resources that are not based on
-Azure.ResourceManager common types.
+Azure.ResourceManager common types. It marks a model as an ARM virtual resource,
+which is useful for defining the scope of resources used only as parents for child resources, or scopes for extension resources.
 
 ```typespec
 @Azure.ResourceManager.armVirtualResource(provider?: valueof string)
@@ -450,10 +481,11 @@ None
 
 #### `@resourceBaseType`
 
-This decorator sets the base type of the given resource.
+This decorator sets the base type of the given resource, indicating where in the
+Azure Resource Manager hierarchy the resource is located.
 
 ```typespec
-@Azure.ResourceManager.resourceBaseType(baseTypeIt: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension")
+@Azure.ResourceManager.resourceBaseType(baseType: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension")
 ```
 
 ##### Target
@@ -462,9 +494,9 @@ This decorator sets the base type of the given resource.
 
 ##### Parameters
 
-| Name       | Type                                                                         | Description                                                                                                            |
-| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| baseTypeIt | `"Tenant" \| "Subscription" \| "ResourceGroup" \| "Location" \| "Extension"` | The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension" |
+| Name     | Type                                                                         | Description                                                                                                            |
+| -------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| baseType | `"Tenant" \| "Subscription" \| "ResourceGroup" \| "Location" \| "Extension"` | The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension" |
 
 #### `@resourceGroupResource`
 

package/dist/generated-defs/Azure.ResourceManager.d.ts

@@ -5,14 +5,15 @@ export interface ResourceOperationOptions {
     readonly omitTags?: boolean;
 }
 /**
- * Marks the operation as being a collection action
+ * Marks the operation as being a collection action that is not associated with a specific resource instance.
+ * Collection actions are operations that act on a resource collection rather than a single resource,
+ * such as `checkNameAvailability` or provider-level actions.
  */
 export type ArmResourceCollectionActionDecorator = (context: DecoratorContext, target: Operation) => DecoratorValidatorCallbacks | void;
 /**
- * `@armResourceType` sets the value fo the decorated string
- * property to the type of the Azure Resource Manager resource.
- *
- * @param resource The resource to get the type of
+ * `@armProviderNameValue` sets the provider namespace value on operations.
+ * It is used internally to inject the correct provider namespace path segment
+ * for resource operations in auto-generated routes.
  */
 export type ArmProviderNameValueDecorator = (context: DecoratorContext, target: Operation) => DecoratorValidatorCallbacks | void;
 /**
@@ -44,7 +45,6 @@ export type IdentifiersDecorator = (context: DecoratorContext, entity: ModelProp
  *  namespace Microsoft.ContosoService;
  * ```
  * @param providerNamespace Provider namespace
- * @param libraryNamespaces a library namespace containing types for this namespace
  */
 export type ArmProviderNamespaceDecorator = (context: DecoratorContext, target: Namespace, providerNamespace?: string) => DecoratorValidatorCallbacks | void;
 /**
@@ -55,7 +55,9 @@ export type ArmProviderNamespaceDecorator = (context: DecoratorContext, target:
  */
 export type UseLibraryNamespaceDecorator = (context: DecoratorContext, target: Namespace, ...namespaces: Namespace[]) => DecoratorValidatorCallbacks | void;
 /**
- * `@armLibraryNamespace` designates a namespace as containign Azure Resource Manager Provider information.
+ * `@armLibraryNamespace` designates a namespace as containing Azure Resource Manager Provider information.
+ * This is used for library namespaces that define reusable ARM resource types that can be shared
+ * across multiple provider specifications.
  *
  * @example
  * ```typespec
@@ -124,48 +126,55 @@ export type ResourceGroupResourceDecorator = (context: DecoratorContext, target:
  */
 export type ExtensionResourceDecorator = (context: DecoratorContext, target: Model) => DecoratorValidatorCallbacks | void;
 /**
- *
- *
+ * Marks the operation as a custom action on a specific Azure Resource Manager resource type.
+ * This decorator associates a POST action operation with its resource,
+ * identifying the semantics of the operation as a resource action over a specific resource for documentation,
+ * resource validation, and use by downstream emitters.
  *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
 export type ArmResourceActionDecorator = (context: DecoratorContext, target: Operation, resourceModel: Model, resourceName?: string) => DecoratorValidatorCallbacks | void;
 /**
- *
- *
+ * Marks the operation as a create or update (PUT) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a CreateOrReplace lifecycle operation over a particular resource,
+ * for use in documentation, resource validation, and downstream emitters.
  *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
 export type ArmResourceCreateOrUpdateDecorator = (context: DecoratorContext, target: Operation, resourceModel: Model, resourceName?: string) => DecoratorValidatorCallbacks | void;
 /**
- *
- *
+ * Marks the operation as a read (GET) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a Read lifecycle operation over a particular resource,
+ * for use in documentation, resource validation, and downstream emitters.
  *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
 export type ArmResourceReadDecorator = (context: DecoratorContext, target: Operation, resourceModel: Model, resourceName?: string) => DecoratorValidatorCallbacks | void;
 /**
- *
- *
+ * Marks the operation as an update (PATCH) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the operation as an Update lifecycle operation over the resource for use in documentation,
+ * resource validation, and downstream emitters.
  *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
 export type ArmResourceUpdateDecorator = (context: DecoratorContext, target: Operation, resourceModel: Model, resourceName?: string) => DecoratorValidatorCallbacks | void;
 /**
- *
- *
+ * Marks the operation as a delete (DELETE) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the operation as a Delete lifecycle operation over the resource for us in documentation,
+ * resource validation, and downstream emitters.
  *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
 export type ArmResourceDeleteDecorator = (context: DecoratorContext, target: Operation, resourceModel: Model, resourceName?: string) => DecoratorValidatorCallbacks | void;
 /**
- *
- *
+ * Marks the operation as a list (GET collection) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a collection list operation over a resource type and a particular scope for documentation,
+ * resource validation, and downstream emitters.
  *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
@@ -209,18 +218,19 @@ export type ArmResourceOperationsDecorator = (context: DecoratorContext, target:
 export type ArmCommonTypesVersionDecorator = (context: DecoratorContext, target: Namespace | EnumMember, version: string | EnumValue) => DecoratorValidatorCallbacks | void;
 /**
  * This decorator is used on Azure Resource Manager resources that are not based on
- * Azure.ResourceManager common types.
+ * Azure.ResourceManager common types. It marks a model as an ARM virtual resource,
+ * which is useful for defining the scope of resources used only as parents for child resources, or scopes for extension resources.
  *
- * @param propertiesType : The type of the resource properties.
  * @param provider Optional. The resource provider namespace for the virtual resource.
  */
 export type ArmVirtualResourceDecorator = (context: DecoratorContext, target: Model, provider?: string) => DecoratorValidatorCallbacks | void;
 /**
- * This decorator sets the base type of the given resource.
+ * This decorator sets the base type of the given resource, indicating where in the
+ * Azure Resource Manager hierarchy the resource is located.
  *
- * @param baseTypeIt The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension"
+ * @param baseType The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension"
  */
-export type ResourceBaseTypeDecorator = (context: DecoratorContext, target: Model, baseTypeIt: Type) => DecoratorValidatorCallbacks | void;
+export type ResourceBaseTypeDecorator = (context: DecoratorContext, target: Model, baseType: Type) => DecoratorValidatorCallbacks | void;
 export type AzureResourceManagerDecorators = {
     armResourceCollectionAction: ArmResourceCollectionActionDecorator;
     armProviderNameValue: ArmProviderNameValueDecorator;

package/dist/generated-defs/Azure.ResourceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Azure.ResourceManager.d.ts","sourceRoot":"","sources":["../../generated-defs/Azure.ResourceManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Azure.ResourceManager.d.ts","sourceRoot":"","sources":["../../generated-defs/Azure.ResourceManager.ts"],"names":[],"mappings":"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"}

package/lib/common-types/nsp-operations.tsp

@@ -92,7 +92,7 @@ interface NspConfigurationOperations<
   ResourceParameter extends {} = NspConfigurationNameParameter<NspConfigurationKeyName>
 > {
   /**
-   * @dev List the network security perimeter configurations to a resource
+   * List the network security perimeter configurations to a resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Resource Optional. The NspConfiguration resource being listed
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -127,7 +127,7 @@ interface NspConfigurationOperations<
   >;
 
   /**
-   * @dev List the network security parameter configuration for a resource without pagination - this should only be used for legacy operations
+   * List the network security parameter configuration for a resource without pagination - this should only be used for legacy operations
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Resource Optional. The NspConfiguration resource being listed
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -162,7 +162,7 @@ interface NspConfigurationOperations<
   >;
 
   /**
-   * @dev GET a network security perimeter configuration for a particular resource
+   * GET a network security perimeter configuration for a particular resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Resource the NspConfiguration resource being read
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -196,7 +196,7 @@ interface NspConfigurationOperations<
   >;
 
   /**
-   * @dev Perform an action on a network security perimeter configuration for a particular resource
+   * Perform an action on a network security perimeter configuration for a particular resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Request The request body type
    * @template Response The success response for the read operation
@@ -238,7 +238,7 @@ interface NspConfigurationOperations<
   ): Response | Error;
 
   /**
-   * @dev Perform an action on a network security perimeter configuration for a particular resource
+   * Perform an action on a network security perimeter configuration for a particular resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Request The request body type
    * @template Response The success response for the read operation

package/lib/common-types/types.tsp

@@ -344,8 +344,7 @@ union createdByType {
   string,
 }
 
-/** @dev Resource Identity Type */
-@doc("")
+/** Resource Identity Type */
 union ResourceIdentityType {
   SystemAssigned: "SystemAssigned",
 }
@@ -369,7 +368,7 @@ model Identity {
   type?: ResourceIdentityType;
 }
 
-/** @dev Properties of a KeyVault */
+/** Properties of a KeyVault */
 model KeyVaultProperties {
   /** Key vault uri to access the encryption key. */
   keyIdentifier?: string;

package/lib/decorators.tsp

@@ -19,7 +19,6 @@ namespace Azure.ResourceManager;
  * ```
  *
  * @param providerNamespace Provider namespace
- * @param libraryNamespaces a library namespace containing types for this namespace
  *
  */
 extern dec armProviderNamespace(target: Namespace, providerNamespace?: valueof string);
@@ -32,7 +31,9 @@ extern dec armProviderNamespace(target: Namespace, providerNamespace?: valueof s
 extern dec useLibraryNamespace(target: Namespace, ...namespaces: Namespace[]);
 
 /**
- * `@armLibraryNamespace` designates a namespace as containign Azure Resource Manager Provider information.
+ * `@armLibraryNamespace` designates a namespace as containing Azure Resource Manager Provider information.
+ * This is used for library namespaces that define reusable ARM resource types that can be shared
+ * across multiple provider specifications.
  *
  * @example
  *
@@ -110,18 +111,25 @@ extern dec resourceGroupResource(target: Model);
 extern dec extensionResource(target: Model);
 
 /**
- * `@armResourceType` sets the value fo the decorated string
- * property to the type of the Azure Resource Manager resource.
- * @param resource The resource to get the type of
+ * `@armProviderNameValue` sets the provider namespace value on operations.
+ * It is used internally to inject the correct provider namespace path segment
+ * for resource operations in auto-generated routes.
  */
 extern dec armProviderNameValue(target: Operation);
 
 /**
- * Marks the operation as being a collection action
+ * Marks the operation as being a collection action that is not associated with a specific resource instance.
+ * Collection actions are operations that act on a resource collection rather than a single resource,
+ * such as `checkNameAvailability` or provider-level actions.
  */
 extern dec armResourceCollectionAction(target: Operation);
 
 /**
+ * Marks the operation as a custom action on a specific Azure Resource Manager resource type.
+ * This decorator associates a POST action operation with its resource,
+ * identifying the semantics of the operation as a resource action over a specific resource for documentation,
+ * resource validation, and use by downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -132,6 +140,10 @@ extern dec armResourceAction(
 );
 
 /**
+ * Marks the operation as a create or update (PUT) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a CreateOrReplace lifecycle operation over a particular resource,
+ * for use in documentation, resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -142,12 +154,20 @@ extern dec armResourceCreateOrUpdate(
 );
 
 /**
+ * Marks the operation as a read (GET) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a Read lifecycle operation over a particular resource,
+ * for use in documentation, resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
 extern dec armResourceRead(target: Operation, resourceModel: Model, resourceName?: valueof string);
 
 /**
+ * Marks the operation as an update (PATCH) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the operation as an Update lifecycle operation over the resource for use in documentation,
+ * resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -158,6 +178,10 @@ extern dec armResourceUpdate(
 );
 
 /**
+ * Marks the operation as a delete (DELETE) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the operation as a Delete lifecycle operation over the resource for us in documentation,
+ * resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -168,6 +192,10 @@ extern dec armResourceDelete(
 );
 
 /**
+ * Marks the operation as a list (GET collection) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a collection list operation over a resource type and a particular scope for documentation,
+ * resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -242,21 +270,22 @@ extern dec armCommonTypesVersion(
 
 /**
  * This decorator is used on Azure Resource Manager resources that are not based on
- * Azure.ResourceManager common types.
+ * Azure.ResourceManager common types. It marks a model as an ARM virtual resource,
+ * which is useful for defining the scope of resources used only as parents for child resources, or scopes for extension resources.
  *
- * @param propertiesType: The type of the resource properties.
  * @param provider Optional. The resource provider namespace for the virtual resource.
  */
 extern dec armVirtualResource(target: Model, provider?: valueof string);
 
 /**
- * This decorator sets the base type of the given resource.
+ * This decorator sets the base type of the given resource, indicating where in the
+ * Azure Resource Manager hierarchy the resource is located.
  *
- * @param baseTypeIt The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension"
+ * @param baseType The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension"
  */
 extern dec resourceBaseType(
   target: Model,
-  baseTypeIt: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension"
+  baseType: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension"
 );
 
 /**

package/lib/extension/operations.tsp

@@ -176,7 +176,7 @@ op CreateOrReplaceSync<
 >;
 
 /**
- * @dev A long-running resource CreateOrUpdate (PUT)
+ * A long-running resource CreateOrUpdate (PUT)
  * @template TargetResource the target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource the resource being created or replaced
  * @template LroHeaders Optional.  Allows overriding the lro headers returned on resource create
@@ -288,7 +288,7 @@ op CustomPatchSync<
 >;
 
 /**
- * @dev Delete a resource asynchronously
+ * Delete a resource asynchronously
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being deleted
  * @template Response The response type for the operation
@@ -314,7 +314,7 @@ op DeleteAsyncBase<
   | Error;
 
 /**
- * @dev Delete a resource asynchronously.
+ * Delete a resource asynchronously.
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being deleted
  * @template LroHeaders Optional. Allows overriding the headers in the Accepted response
@@ -351,7 +351,7 @@ op DeleteAsync<
 >;
 
 /**
- * @dev Delete a resource asynchronously
+ * Delete a resource asynchronously
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being deleted
  * @template LroHeaders Optional. Allows overriding the headers returned in the Accepted response
@@ -444,7 +444,7 @@ op ActionAsyncBase<
 ): Response | Error;
 
 /**
- * @dev A long-running resource action.
+ * A long-running resource action.
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being acted upon
  * @template Request The request model for the action
@@ -459,6 +459,7 @@ op ActionAsyncBase<
 @extensionResourceOperation(TargetResource, ExtensionResource, "action", OverrideResourceName)
 @returnsDoc("Azure operation completed successfully.")
 @enforceConstraint(ExtensionResource, Foundations.Resource)
+@doc("")
 op ActionAsync<
   TargetResource extends Foundations.SimpleResource,
   ExtensionResource extends Foundations.SimpleResource,
@@ -520,7 +521,7 @@ op ActionSync<
 ): Response | Error;
 
 /**
- * @dev A long-running resource action that returns no content.
+ * A long-running resource action that returns no content.
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being acted upon
  * @template Request The request model for the action
@@ -535,6 +536,7 @@ op ActionSync<
 @enforceConstraint(TargetResource, Foundations.Resource)
 @enforceConstraint(ExtensionResource, Foundations.Resource)
 @post
+@doc("")
 op ActionNoResponseContentAsync<
   TargetResource extends Foundations.SimpleResource,
   ExtensionResource extends Foundations.SimpleResource,

package/lib/foundations/arm.foundations.tsp

@@ -140,29 +140,37 @@ alias TenantParentScope<Resource extends Foundations.SimpleResource> = TenantSco
  * Parameter model for listing a resource at the tenant scope
  * @template Resource The type of the resource.
  */
-model TenantScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, TenantBaseParameters>;
+model TenantScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  TenantBaseParameters
+>;
 
 /**
  * Parameter model for listing a resource at the subscription scope
  * @template Resource The type of the resource.
  */
-model SubscriptionScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, SubscriptionBaseParameters>;
+model SubscriptionScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  SubscriptionBaseParameters
+>;
 
 /**
  * Parameter model for listing a resource at the location scope
  * @template Resource The type of the resource.
  */
-model LocationScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, LocationBaseParameters>;
+model LocationScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  LocationBaseParameters
+>;
 
 /**
  * Parameter model for listing an extension resource
  * @template Resource The type of the resource.
  */
-model ExtensionScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, ExtensionBaseParameters>;
+model ExtensionScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  ExtensionBaseParameters
+>;
 
 /**
  * Parameter model for listing a resource at the resource group scope
@@ -240,22 +248,24 @@ op checkNameAvailability<
 ): Response | ErrorResponse;
 
 /**
- * @dev The base template for Azure Resource Manager GET and HEAD Operations.
+ * The base template for Azure Resource Manager GET and HEAD Operations.
  * @template Parameters The parameter object for the operation.
  * @template Response The response or union of responses for success.
  * @template ErrorResponse The error response.
  */
+@doc("")
 op ArmReadOperation<Parameters extends {}, Response extends {}, ErrorResponse extends {}>(
   ...Parameters,
 ): Response | ErrorResponse;
 
 /**
- * @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.
  */
+@doc("")
 op ArmCreateOperation<
   HttpParameters extends {},
   BodyParameter extends {},
@@ -266,12 +276,13 @@ op ArmCreateOperation<
   | ErrorResponse;
 
 /**
- * @dev The base template for Azure Resource Manager PATCH Operations.
+ * The base template for 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.
  */
+@doc("")
 op ArmUpdateOperation<
   HttpParameters extends {},
   BodyParameter extends {},