[Modules] Update parent-child resource conditional description & updated format

arm/Microsoft.AAD/DomainServices/deploy.bicep

@@ -12,10 +12,10 @@ param domainName string
 ])
 param sku string = 'Standard'
 
-@description('Optional. The location to deploy the Azure ADDS Services')
+@description('Optional. The location to deploy the Azure ADDS Services.')
 param location string = resourceGroup().location
 
-@description('Optional. Additional replica set for the managed domain')
+@description('Optional. Additional replica set for the managed domain.')
 param replicaSets array = []
 
 @description('Conditional. Required if secure LDAP is enabled and must be valid more than 30 days. The certificate required to configure Secure LDAP. Should be a base64encoded representation of the certificate PFX file.')
@@ -25,10 +25,10 @@ param pfxCertificate string = ''
 @secure()
 param pfxCertificatePassword string = ''
 
-@description('Optional. The email recipient value to receive alerts')
+@description('Optional. The email recipient value to receive alerts.')
 param additionalRecipients array = []
 
-@description('Optional. The value is to provide domain configuration type')
+@description('Optional. The value is to provide domain configuration type.')
 @allowed([
   'FullySynced'
   'ResourceTrusting'
@@ -80,7 +80,7 @@ param kerberosRc4Encryption string = 'Enabled'
 ])
 param kerberosArmoring string = 'Enabled'
 
-@description('Optional. The value is to notify the DC Admins. ')
+@description('Optional. The value is to notify the DC Admins.')
 @allowed([
   'Enabled'
   'Disabled'
@@ -94,7 +94,7 @@ param notifyDcAdmins string = 'Enabled'
 ])
 param notifyGlobalAdmins string = 'Enabled'
 
-@description('Optional. The value is to enable the Secure LDAP for external services of Azure ADDS Services')
+@description('Optional. The value is to enable the Secure LDAP for external services of Azure ADDS Services.')
 @allowed([
   'Enabled'
   'Disabled'
@@ -136,7 +136,7 @@ param diagnosticLogsRetentionInDays int = 365
 @description('Optional. Specify the type of lock.')
 param lock string = 'NotSpecified'
 
-@description('Optional. Array of role assignment objects that contain the \'roleDefinitionIdOrName\' and \'principalId\' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: \'/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11\'')
+@description('Optional. Array of role assignment objects that contain the \'roleDefinitionIdOrName\' and \'principalId\' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: \'/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11\'.')
 param roleAssignments array = []
 
 @description('Optional. The name of logs that will be streamed.')
@@ -236,11 +236,11 @@ module domainService_rbac '.bicep/nested_rbac.bicep' = [for (roleAssignment, ind
   }
 }]
 
-@description('The domain name of the Azure Active Directory Domain Services(Azure ADDS)')
+@description('The domain name of the Azure Active Directory Domain Services(Azure ADDS).')
 output name string = domainService.name
 
 @description('The name of the resource group the Azure Active Directory Domain Services(Azure ADDS) was created in.')
 output resourceGroupName string = resourceGroup().name
 
-@description('The resource ID of the Azure Active Directory Domain Services(Azure ADDS)')
+@description('The resource ID of the Azure Active Directory Domain Services(Azure ADDS).')
 output resourceId string = domainService.id

arm/Microsoft.AAD/DomainServices/readme.md

@@ -34,27 +34,27 @@ This template deploys Azure Active Directory Domain Services (AADDS).
 **Optional parameters**
 | Parameter Name | Type | Default Value | Allowed Values | Description |
 | :-- | :-- | :-- | :-- | :-- |
-| `additionalRecipients` | array | `[]` |  | The email recipient value to receive alerts |
+| `additionalRecipients` | array | `[]` |  | The email recipient value to receive alerts. |
 | `diagnosticEventHubAuthorizationRuleId` | string | `''` |  | Resource ID of the diagnostic event hub authorization rule for the Event Hubs namespace in which the event hub should be created or streamed to. |
 | `diagnosticEventHubName` | string | `''` |  | Name of the diagnostic event hub within the namespace to which logs are streamed. Without this, an event hub is created for each log category. |
 | `diagnosticLogsRetentionInDays` | int | `365` |  | Specifies the number of days that logs will be kept for; a value of 0 will retain data indefinitely. |
 | `diagnosticStorageAccountId` | string | `''` |  | Resource ID of the diagnostic storage account. |
 | `diagnosticWorkspaceId` | string | `''` |  | Resource ID of the diagnostic log analytics workspace. |
-| `domainConfigurationType` | string | `'FullySynced'` | `[FullySynced, ResourceTrusting]` | The value is to provide domain configuration type |
-| `externalAccess` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to enable the Secure LDAP for external services of Azure ADDS Services |
+| `domainConfigurationType` | string | `'FullySynced'` | `[FullySynced, ResourceTrusting]` | The value is to provide domain configuration type. |
+| `externalAccess` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to enable the Secure LDAP for external services of Azure ADDS Services. |
 | `filteredSync` | string | `'Enabled'` |  | The value is to synchronise scoped users and groups. |
 | `kerberosArmoring` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to enable to provide a protected channel between the Kerberos client and the KDC. |
 | `kerberosRc4Encryption` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to enable Kerberos requests that use RC4 encryption. |
 | `ldaps` | string | `'Enabled'` | `[Enabled, Disabled]` | A flag to determine whether or not Secure LDAP is enabled or disabled. |
-| `location` | string | `[resourceGroup().location]` |  | The location to deploy the Azure ADDS Services |
+| `location` | string | `[resourceGroup().location]` |  | The location to deploy the Azure ADDS Services. |
 | `lock` | string | `'NotSpecified'` | `[CanNotDelete, NotSpecified, ReadOnly]` | Specify the type of lock. |
 | `logsToEnable` | array | `[SystemSecurity, AccountManagement, LogonLogoff, ObjectAccess, PolicyChange, PrivilegeUse, DetailTracking, DirectoryServiceAccess, AccountLogon]` | `[SystemSecurity, AccountManagement, LogonLogoff, ObjectAccess, PolicyChange, PrivilegeUse, DetailTracking, DirectoryServiceAccess, AccountLogon]` | The name of logs that will be streamed. |
 | `name` | string | `[parameters('domainName')]` |  | The name of the AADDS resource. Defaults to the domain name specific to the Azure ADDS service. |
-| `notifyDcAdmins` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to notify the DC Admins.  |
+| `notifyDcAdmins` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to notify the DC Admins. |
 | `notifyGlobalAdmins` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to notify the Global Admins. |
 | `ntlmV1` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to enable clients making request using NTLM v1. |
-| `replicaSets` | array | `[]` |  | Additional replica set for the managed domain |
-| `roleAssignments` | array | `[]` |  | Array of role assignment objects that contain the 'roleDefinitionIdOrName' and 'principalId' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: '/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11' |
+| `replicaSets` | array | `[]` |  | Additional replica set for the managed domain. |
+| `roleAssignments` | array | `[]` |  | Array of role assignment objects that contain the 'roleDefinitionIdOrName' and 'principalId' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: '/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11'. |
 | `sku` | string | `'Standard'` | `[Standard, Enterprise, Premium]` | The name of the SKU specific to Azure ADDS Services. |
 | `syncNtlmPasswords` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to enable synchronized users to use NTLM authentication. |
 | `syncOnPremPasswords` | string | `'Enabled'` | `[Enabled, Disabled]` | The value is to enable on-premises users to authenticate against managed domain. |
@@ -141,6 +141,6 @@ $pfxCertificate = [System.Convert]::ToBase64String($rawCertByteStream)
 
 | Output Name | Type | Description |
 | :-- | :-- | :-- |
-| `name` | string | The domain name of the Azure Active Directory Domain Services(Azure ADDS) |
+| `name` | string | The domain name of the Azure Active Directory Domain Services(Azure ADDS). |
 | `resourceGroupName` | string | The name of the resource group the Azure Active Directory Domain Services(Azure ADDS) was created in. |
-| `resourceId` | string | The resource ID of the Azure Active Directory Domain Services(Azure ADDS) |
+| `resourceId` | string | The resource ID of the Azure Active Directory Domain Services(Azure ADDS). |

arm/Microsoft.AnalysisServices/servers/deploy.bicep

@@ -47,7 +47,7 @@ param diagnosticEventHubName string = ''
 @description('Optional. Specify the type of lock.')
 param lock string = 'NotSpecified'
 
-@description('Optional. Array of role assignment objects that contain the \'roleDefinitionIdOrName\' and \'principalId\' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: \'/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11\'')
+@description('Optional. Array of role assignment objects that contain the \'roleDefinitionIdOrName\' and \'principalId\' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: \'/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11\'.')
 param roleAssignments array = []
 
 @description('Optional. Tags of the resource.')
@@ -154,11 +154,11 @@ module server_rbac '.bicep/nested_rbac.bicep' = [for (roleAssignment, index) in
   }
 }]
 
-@description('The name of the analysis service')
+@description('The name of the analysis service.')
 output name string = server.name
 
-@description('The resource ID of the analysis service')
+@description('The resource ID of the analysis service.')
 output resourceId string = server.id
 
-@description('The resource group the analysis service was deployed into')
+@description('The resource group the analysis service was deployed into.')
 output resourceGroupName string = resourceGroup().name

arm/Microsoft.AnalysisServices/servers/readme.md

@@ -39,7 +39,7 @@ This module deploys an Analysis Services Server.
 | `firewallSettings` | object | `{object}` |  | The inbound firewall rules to define on the server. If not specified, firewall is disabled. |
 | `location` | string | `[resourceGroup().location]` |  | Location for all Resources. |
 | `lock` | string | `'NotSpecified'` | `[CanNotDelete, NotSpecified, ReadOnly]` | Specify the type of lock. |
-| `roleAssignments` | array | `[]` |  | Array of role assignment objects that contain the 'roleDefinitionIdOrName' and 'principalId' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: '/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11' |
+| `roleAssignments` | array | `[]` |  | Array of role assignment objects that contain the 'roleDefinitionIdOrName' and 'principalId' to define RBAC role assignments on this resource. In the roleDefinitionIdOrName attribute, you can provide either the display name of the role definition, or its fully qualified ID in the following format: '/providers/Microsoft.Authorization/roleDefinitions/c2f4ef07-c644-48eb-af81-4b1b4947fb11'. |
 | `skuCapacity` | int | `1` |  | The total number of query replica scale-out instances. |
 | `skuName` | string | `'S0'` |  | The SKU name of the Azure Analysis Services server to create. |
 | `tags` | object | `{object}` |  | Tags of the resource. |
@@ -92,6 +92,6 @@ Create a role assignment for the given resource. If you want to assign a service
 
 | Output Name | Type | Description |
 | :-- | :-- | :-- |
-| `name` | string | The name of the analysis service |
-| `resourceGroupName` | string | The resource group the analysis service was deployed into |
-| `resourceId` | string | The resource ID of the analysis service |
+| `name` | string | The name of the analysis service. |
+| `resourceGroupName` | string | The resource group the analysis service was deployed into. |
+| `resourceId` | string | The resource ID of the analysis service. |

arm/Microsoft.ApiManagement/service/.bicep/nested_authorizationServers.bicep

@@ -1,7 +1,7 @@
 @description('Required. Identifier of the authorization server.')
 param name string
 
-@description('Required. The name of the of the API Management service.')
+@description('Required. The name of the API Management service.')
 param apiManagementServiceName string
 
 @description('Required. OAuth authorization endpoint. See <http://tools.ietf.org/html/rfc6749#section-3.2>.')

arm/Microsoft.ApiManagement/service/apiVersionSets/deploy.bicep

@@ -1,13 +1,13 @@
-@description('Required. The name of the of the API Management service.')
+@description('Conditional. The name of the parent API Management service. Required if the template is used in a standalone deployment.')
 param apiManagementServiceName string
 
 @description('Optional. Enable telemetry via the Customer Usage Attribution ID (GUID).')
 param enableDefaultTelemetry bool = true
 
-@description('Optional. API Version set name')
+@description('Optional. API Version set name.')
 param name string = 'default'
 
-@description('Optional. API Version set properties')
+@description('Optional. API Version set properties.')
 param properties object = {}
 
 resource defaultTelemetry 'Microsoft.Resources/deployments@2021-04-01' = if (enableDefaultTelemetry) {
@@ -32,11 +32,11 @@ resource apiVersionSet 'Microsoft.ApiManagement/service/apiVersionSets@2021-08-0
   properties: properties
 }
 
-@description('The resource ID of the API Version set')
+@description('The resource ID of the API Version set.')
 output resourceId string = apiVersionSet.id
 
-@description('The name of the API Version set')
+@description('The name of the API Version set.')
 output name string = apiVersionSet.name
 
-@description('The resource group the API Version set was deployed into')
+@description('The resource group the API Version set was deployed into.')
 output resourceGroupName string = resourceGroup().name

arm/Microsoft.ApiManagement/service/apiVersionSets/readme.md

@@ -16,23 +16,23 @@ This module deploys API Management Service APIs Version Set.
 
 ## Parameters
 
-**Required parameters**
+**Conditional parameters**
 | Parameter Name | Type | Description |
 | :-- | :-- | :-- |
-| `apiManagementServiceName` | string | The name of the of the API Management service. |
+| `apiManagementServiceName` | string | The name of the parent API Management service. Required if the template is used in a standalone deployment. |
 
 **Optional parameters**
 | Parameter Name | Type | Default Value | Description |
 | :-- | :-- | :-- | :-- |
 | `enableDefaultTelemetry` | bool | `True` | Enable telemetry via the Customer Usage Attribution ID (GUID). |
-| `name` | string | `'default'` | API Version set name |
-| `properties` | object | `{object}` | API Version set properties |
+| `name` | string | `'default'` | API Version set name. |
+| `properties` | object | `{object}` | API Version set properties. |
 
 
 ## Outputs
 
 | Output Name | Type | Description |
 | :-- | :-- | :-- |
-| `name` | string | The name of the API Version set |
-| `resourceGroupName` | string | The resource group the API Version set was deployed into |
-| `resourceId` | string | The resource ID of the API Version set |
+| `name` | string | The name of the API Version set. |
+| `resourceGroupName` | string | The resource group the API Version set was deployed into. |
+| `resourceId` | string | The resource ID of the API Version set. |

arm/Microsoft.ApiManagement/service/apis/deploy.bicep

@@ -4,10 +4,10 @@ param name string
 @description('Optional. Array of Policies to apply to the Service API.')
 param policies array = []
 
-@description('Required. The name of the of the API Management service.')
+@description('Conditional. The name of the parent API Management service. Required if the template is used in a standalone deployment.')
 param apiManagementServiceName string
 
-@description('Optional. Describes the Revision of the API. If no value is provided, default revision 1 is created')
+@description('Optional. Describes the Revision of the API. If no value is provided, default revision 1 is created.')
 param apiRevision string = ''
 
 @description('Optional. Description of the API Revision.')
@@ -20,10 +20,10 @@ param apiRevisionDescription string = ''
 ])
 param apiType string = 'http'
 
-@description('Optional. Indicates the Version identifier of the API if the API is versioned')
+@description('Optional. Indicates the Version identifier of the API if the API is versioned.')
 param apiVersion string = ''
 
-@description('Optional. Indicates the Version identifier of the API version set')
+@description('Optional. Indicates the Version identifier of the API version set.')
 param apiVersionSetId string = ''
 
 @description('Optional. Description of the API Version.')
@@ -63,7 +63,7 @@ param isCurrent bool = true
 @description('Required. Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API.')
 param path string
 
-@description('Optional. Describes on which protocols the operations in this API can be invoked. - HTTP or HTTPS')
+@description('Optional. Describes on which protocols the operations in this API can be invoked. - HTTP or HTTPS.')
 param protocols array = [
   'https'
 ]
@@ -148,11 +148,11 @@ module policy 'policies/deploy.bicep' = [for (policy, index) in policies: {
   }
 }]
 
-@description('The name of the API management service API')
+@description('The name of the API management service API.')
 output name string = api.name
 
-@description('The resource ID of the API management service API')
+@description('The resource ID of the API management service API.')
 output resourceId string = api.id
 
-@description('The resource group the API management service API was deployed to')
+@description('The resource group the API management service API was deployed to.')
 output resourceGroupName string = resourceGroup().name

arm/Microsoft.ApiManagement/service/apis/policies/deploy.bicep

@@ -1,10 +1,10 @@
-@description('Required. The name of the of the API Management service.')
+@description('Conditional. The name of the parent API Management service. Required if the template is used in a standalone deployment.')
 param apiManagementServiceName string
 
-@description('Required. The name of the of the API.')
+@description('Conditional. The name of the parent API. Required if the template is used in a standalone deployment.')
 param apiName string
 
-@description('Optional. The name of the policy')
+@description('Optional. The name of the policy.')
 param name string = 'policy'
 
 @description('Optional. Enable telemetry via the Customer Usage Attribution ID (GUID).')
@@ -51,11 +51,11 @@ resource policy 'Microsoft.ApiManagement/service/apis/policies@2021-08-01' = {
   }
 }
 
-@description('The resource ID of the API policy')
+@description('The resource ID of the API policy.')
 output resourceId string = policy.id
 
-@description('The name of the API policy')
+@description('The name of the API policy.')
 output name string = policy.name
 
-@description('The resource group the API policy was deployed into')
+@description('The resource group the API policy was deployed into.')
 output resourceGroupName string = resourceGroup().name