@microsoft/terraform-cdk-constructs 0.0.3-pre.6 → 0.0.3-pre.7

package/.jsii

@@ -1470,7 +1470,7 @@
   },
   "name": "@microsoft/terraform-cdk-constructs",
   "readme": {
-    "markdown": "# Terraform-Azure-CDK-Modules\n\nThis repository contains code for building infrastructure using Terraform Azure CDK modules.\n\n\n\n## Using the Libraries\n\nThis project includes several libraries for building infrastructure using Azure modules. Here are some examples of how to use them:\n\n### Example 1: Creating a Virtual Machine\n\n```typescript\nimport { VirtualMachine } from '@my-awesome-infra/virtual-machine';\n\nconst vm = new VirtualMachine({\n  name: 'my-vm',\n  location: 'eastus',\n  resourceGroup: 'my-resource-group',\n  size: 'Standard_D2s_v3',\n  osDisk: {\n    storageAccountType: 'Standard_LRS',\n    diskSizeGB: 128,\n  },\n  adminUsername: 'admin',\n  adminPassword: 'password',\n});\n```\n\n## Contributing\n\nThis project welcomes contributions and suggestions.  Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nWe welcome contributions to this project! See our documentation on [how to get started contributing](./docs/CONTRIBUTING.md).\n\n## Code Spaces\n\nTo open this repository in a Code Space, click the button below:\n\n[![Open in Code Spaces](https://img.shields.io/badge/Open%20in%20Code%20Spaces-Terraform%20Azure%20CDK%20Modules%20Project-blue?logo=github)](https://github.com/microsoft/terraform-azure-cdk-modules/codespaces)\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow\n[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n"
+    "markdown": "# Azure Terraform CDK Constructs\nWelcome to the Azure Terraform CDK Constructs project! This library offers a comprehensive suite of L2 Constructs designed to simplify and enhance the experience of building and managing Azure infrastructure with the Cloud Development Kit for Terraform (CDKTF).\n\n## Benefits of Using L2 Constructs\n\nWith L2 Constructs, you get the following benefits:\n\n- **Abstraction**: Higher-level abstractions over Azure resources make your infrastructure code more declarative and easier to understand.\n- **Reusability**: Encapsulate common patterns and best practices in your infrastructure code, promoting reusability across different projects and teams.\n- **Rapid Development**: Accelerate your cloud development process with pre-built constructs that have been tested for common use cases, allowing you to focus on your unique application logic.\n- **Direct IDE Integration**: Access detailed documentation directly within your Integrated Development Environment (IDE), streamlining your development workflow: ![alt text](./docs/images/ide-documentation.png)\n\n\n## Quick Example\n\nThis is a quick example that showcases the simplicity and power of L2 Constructs. We'll create a storage account, add a container to it, and then upload a blob—all with a few lines of intuitive, object-oriented code:\n\n```typescript\n\n// Create a new instance of a storage account as an object\nconst sa = new azcdk.azure_storageaccount.Account(stack, \"storageaccount\", {\n  name: \"testStorageAccount\",\n  location: \"eastus\",\n});\n\n// Add a container to the storage account by calling a method on the storage account object\nconst container = sa.addContainer(\"testcontainer\");\n\n// Add a blob to the container by calling a method on the container object\n// The path \"../../../test.txt\" points to the source file to be uploaded as a blob\ncontainer.addBlob(\"testblob.txt\", \"../../../test.txt\");\n```\n\n\n\n## Getting Started\n\nThis guide will walk you through the process of using the Azure L2 Constructs to define and provision infrastructure on Azure.\n\n### Prerequisites\nMake sure you have Node.js and npm installed on your machine. These will be used to install the CDK for Terraform and Azure provider packages.\n\n### Installation\n\nFirst, install the CDK for Terraform CLI globally using npm:\n\n```sh\nnpm install -g cdktf-cli\n```\n\nNext, initialize a new CDK for Terraform project with TypeScript template:\n```sh\ncdktf init --template=\"TypeScript\" --local\n```\nInstall the AzureRM provider for CDKTF:\n\n```sh\nnpm install @cdktf/provider-azurerm\n```\n\nThen, add the Microsoft Terraform CDK constructs for Azure:\n\n```sh\nnpm install @micrsoft/terraform-cdk-constructs\n\n```\n\n\n### Example 1: Creating a Storage Account\nNow let's create a simple Azure storage account. The following TypeScript snippet defines a storage account resource using the CDKTF:\n\n```typescript\n// Import necessary modules and classes\nimport * as azcdk from \"@microsoft/terraform-cdk-constructs\";\nimport { Construct } from 'constructs';\nimport { App, TerraformStack } from 'cdktf';\nimport { AzurermProvider } from \"@cdktf/provider-azurerm/lib/provider\";\n\n// Define a new Terraform stack\nclass AzureAppInfra extends TerraformStack {\n constructor(scope: Construct, name: string) {\n   super(scope, name);\n\n   // Initialize Azure provider\n   new AzurermProvider(this, \"azureFeature\", { features: {} });\n\n   // Create a new Azure storage account with the specified name and location\n   new azcdk.azure_storageaccount.Account(this, \"storageaccount\", {\n     name: \"test42348808\",\n     location: \"eastus\",\n   });\n }\n}\n\n// Initialize the CDK app and synthesize Terraform configurations\nconst app = new App();\nnew AzureAppInfra(app, 'cdk');\napp.synth();\n```\nAfter defining your infrastructure, generate the Terraform configuration files:\n```sh\ncdktf synth\n```\nFinally, deploy your infrastructure to Azure:\n\n```sh\ncdktf deploy\n```\n## Supported Languages\n\nCurrently, our CDK L2 constructs are available in the following languages:\n\n| Language   | Status       |\n|------------|--------------|\n| TypeScript | Available    |\n| Python     | Coming soon  |\n| Java       | Coming soon  |\n| Go         | Coming soon  |\n| C#         | Coming soon  |\n\nStay tuned for updates as we work to expand support to other popular programming languages!\n\n\n## Contributing\n\nThis project welcomes contributions and suggestions.  Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\nWe welcome contributions to this project! See our documentation on [how to get started contributing](./docs/CONTRIBUTING.md).\n\n## Code Spaces\n\nTo open this repository in a Code Space, click the button below:\n\n[![Open in Code Spaces](https://img.shields.io/badge/Open%20in%20Code%20Spaces-Terraform%20Azure%20CDK%20Modules%20Project-blue?logo=github)](https://github.com/microsoft/terraform-azure-cdk-modules/codespaces)\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow\n[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n"
   },
   "repository": {
     "type": "git",
@@ -1671,26 +1671,37 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_applicationgateway.Gateway",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "stability": "stable",
+          "summary": "Constructs a new Azure Application Gateway."
         },
         "locationInModule": {
           "filename": "src/azure-applicationgateway/lib/gateway.ts",
-          "line": 216
+          "line": 293
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The ID of this construct."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "The properties include:\n  - `name`: Required. Unique name for the Application Gateway within Azure.\n  - `location`: Required. Azure Region for deployment.\n  - `resourceGroup`: Required. Reference to the resource group for deployment.\n  - `skuTier`: Required. SKU tier of the Application Gateway (e.g., Standard, WAF).\n  - `skuSize`: Required. Size of the SKU for the Application Gateway.\n  - `capacity`: Required. Capacity (instance count) of the Application Gateway.\n  - `backendAddressPools`: Required. Backend address pools for the Application Gateway.\n  - `backendHttpSettings`: Required. Backend HTTP settings for the Application Gateway.\n  - `httpListeners`: Required. HTTP listeners for the Application Gateway.\n  - `requestRoutingRules`: Required. Request routing rules for the Application Gateway.\n  - `publicIpAddress`: Optional. Public IP address for the frontend.\n  - `privateIpAddress`: Optional. Private IP address for the frontend.\n  - `privateIpAddressAllocation`: Optional. Allocation method for the private IP (Static, Dynamic).\n  - `frontendPorts`: Optional. Frontend ports for the Application Gateway.\n  - `subnet`: Optional. Subnet for the Application Gateway.\n  - `enableHttp2`: Optional. Flag to enable HTTP2.\n  - `fipsEnabled`: Optional. Flag to enable FIPS-compliant algorithms.\n  - `firewallPolicyId`: Optional. ID of the firewall policy.\n  - `forceFirewallPolicyAssociation`: Optional. Flag to enforce association of the firewall policy.\n  - `tags`: Optional. Tags for resource management.\n  - Additional optional properties as described in `IGatewayProps` interface.\n\nExample usage:\n```typescript\nnew Gateway(this, 'appGateway1', {\nname: 'gatewayEast',\nresourceGroup: resourceGroup,\nlocation: \"eastus\",\nskuTier: \"Standard_v2\",\nskuSize: \"Standard_v2\",\ncapacity: 2,\npublicIpAddress: publicIp,\nsubnet: subnet,\nbackendAddressPools: [\n{ name: \"backend-address-pool-1\" },\n{\nname: \"backend-address-pool-2\",\nipAddresses: [\"10.1.0.4\", \"10.1.0.5\", \"10.1.0.6\"],\n},\n],\nhttpListeners: [\n{\nname: \"http-listener\",\nfrontendPortName: \"80\",\nfrontendIpConfigurationName: \"Public-frontend-ip-configuration\",\nprotocol: \"Http\",\n},\n],\nbackendHttpSettings: [\n{\nname: \"backend-http-setting\",\nport: 80,\nprotocol: \"Http\",\nrequestTimeout: 20,\ncookieBasedAffinity: \"Disabled\",\n},\n],\nrequestRoutingRules: [\n{\nname: \"request-routing-rule-1\",\nhttpListenerName: \"http-listener\",\npriority: 1,\nbackendAddressPoolName: \"backend-address-pool-1\",\nbackendHttpSettingsName: \"backend-http-setting\",\nruleType: \"Basic\",\n},\n],\n});\n```",
+              "summary": "- The properties for configuring the Azure Application Gateway."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_applicationgateway.IGatewayProps"
@@ -2503,26 +2514,37 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_applicationinsights.AppInsights",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "stability": "stable",
+          "summary": "Constructs a new Azure Application Insights resource."
         },
         "locationInModule": {
           "filename": "src/azure-applicationinsights/lib/appinsights.ts",
-          "line": 64
+          "line": 98
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The ID of this construct."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "The properties include:\n  - `name`: Required. Unique name for the Application Insights resource within Azure.\n  - `location`: Required. Azure Region for deployment.\n  - `resourceGroup`: Required. Reference to the Azure Resource Group for deployment.\n  - `retentionInDays`: Optional. Number of days to retain data. Default is 90 days.\n  - `tags`: Optional. Tags for resource management.\n  - `applicationType`: Required. The type of application (e.g., web, other).\n  - `dailyDataCapInGb`: Optional. Daily data cap in gigabytes.\n  - `dailyDataCapNotificationDisabled`: Optional. Flag to disable notifications when the daily data cap is reached.\n  - `workspaceId`: Optional. ID of the Log Analytics Workspace to associate with Application Insights. If not provided, a new workspace is created automatically.\n\nExample usage:\n```typescript\nnew AppInsights(this, 'myAppInsights', {\nname: 'myAppInsightsResource',\nlocation: 'West US',\nresourceGroup: resourceGroup,\nretentionInDays: 120,\ntags: {\n\"environment\": \"production\"\n},\napplicationType: 'web',\ndailyDataCapInGb: 10,\ndailyDataCapNotificationDisabled: true,\nworkspaceId: 'existing-workspace-id'\n});\n```",
+              "summary": "- The properties for configuring the Azure Application Insights."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_applicationinsights.AppInsightsProps"
@@ -2538,21 +2560,30 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method creates a new secret in the specified Azure Key Vault with the\ninstrumentation key of the Application Insights resource. This enables secure storage\nand management of the instrumentation key, facilitating secure access across various\nAzure services.",
+            "stability": "stable",
+            "summary": "Saves the Application Insights instrumentation key to an Azure Key Vault."
           },
           "locationInModule": {
             "filename": "src/azure-applicationinsights/lib/appinsights.ts",
-            "line": 135
+            "line": 185
           },
           "name": "saveIKeyToKeyVault",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The unique identifier of the Azure Key Vault where the secret will be stored."
+              },
               "name": "keyVaultId",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "Defaults to 'instrumentation-key'.\n  This name can be used to retrieve the secret in client applications.\n\nExample usage:\n```typescript\nappInsightsInstance.saveIKeyToKeyVault('my-key-vault-id');\n```",
+                "summary": "- The name of the secret within the Key Vault."
+              },
               "name": "keyVaultSecretName",
               "optional": true,
               "type": {
@@ -2795,26 +2826,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_containerregistry.Registry",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class creates an Azure Container Registry instance, which is a managed Docker registry service based on the Docker Registry 2.0 specification.\nThis service enables you to store and manage container images across all types of Azure deployments, you can also use it to build, store, and manage images for all types of container deployments.",
+          "stability": "stable",
+          "summary": "Constructs a new Azure Container Registry (ACR)."
         },
         "locationInModule": {
           "filename": "src/azure-containerregistry/lib/registry.ts",
-          "line": 43
+          "line": 72
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically used for managing lifecycles and creation order."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this construct instance."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "The properties include:\n  - `location`: Required. The Azure region where the registry will be deployed.\n  - `name`: Required. The name of the Container Registry.\n  - `resourceGroup`: Required. The Azure Resource Group in which to deploy the registry.\n  - `sku`: Optional. The SKU of the Container Registry (e.g., Basic, Standard, Premium). Determines the features available.\n  - `tags`: Optional. Tags for resource management.\n  - `adminEnabled`: Optional. Specifies whether the admin user is enabled for the registry. Defaults to false if not set.\n  - `geoReplicationLocations`: Optional. Specifies additional Azure regions where the registry should be geo-replicated.\n\nExample usage:\n```typescript\nnew Registry(this, 'myRegistry', {\nlocation: 'West US',\nname: 'myContainerRegistry',\nresourceGroup: resourceGroup,\nsku: 'Premium',\nadminEnabled: true,\ngeoReplicationLocations: ['East US', 'West Europe']\n});\n```",
+              "summary": "- The properties for configuring the Azure Container Registry."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_containerregistry.RegistryProps"
@@ -3023,26 +3066,41 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.AuthorizationRule",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "custom": {
+            "remarks": "The primary connection string and primary key are accessible after the instance creation,\nallowing for integration with other Azure services or client applications."
+          },
+          "remarks": "This class creates an authorization rule which defines the permissions granted to users and applications\nfor accessing and managing the Event Hub. An Authorization Rule can grant listening, sending, and full manage\npermissions based on the properties specified.",
+          "stability": "stable",
+          "summary": "Constructs a new Authorization Rule for an Azure Event Hub."
         },
         "locationInModule": {
           "filename": "src/azure-eventhub/lib/authorization.ts",
-          "line": 32
+          "line": 62
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically used for managing lifecycles and creation order."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique name for this instance of the Authorization Rule."
+            },
             "name": "name",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "The properties include:\n- `name`: Required. The name of the Authorization Rule.\n- `listen`: Optional. Specifies whether the rule allows listening to the Event Hub. Defaults to false.\n- `send`: Optional. Specifies whether the rule allows sending events to the Event Hub. Defaults to false.\n- `manage`: Optional. Specifies whether the rule allows managing the Event Hub, including sending and listening. Defaults to false.\nWhen `manage` is true, both `listen` and `send` are implicitly set to true.\n\nExample usage:\n```typescript\nconst authRule = new AuthorizationRule(this, 'exampleAuthRule', {\nname: 'myAuthRule',\nlisten: true,\nsend: true,\nmanage: false // Only listening and sending are enabled; not managing.\n});\n```",
+              "summary": "- The properties for configuring the Authorization Rule."
+            },
             "name": "ehInstanceAuthProps",
             "type": {
               "fqn": "@cdktf/provider-azurerm.eventhubAuthorizationRule.EventhubAuthorizationRuleConfig"
@@ -3062,7 +3120,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-eventhub/lib/authorization.ts",
-            "line": 85
+            "line": 115
           },
           "name": "addPrimaryConnectionStringToVault",
           "parameters": [
@@ -3093,7 +3151,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-eventhub/lib/authorization.ts",
-            "line": 93
+            "line": 123
           },
           "name": "addPrimaryKeyToVault",
           "parameters": [
@@ -3551,26 +3609,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.Cluster",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class creates an Azure Event Hub Cluster which is a dedicated capacity resource for handling\nhigh-throughput, low-latency event ingestion and streaming. It is used in scenarios where you need\npredictable performance and cost regardless of the volume of data ingress or number of downstream\nevent consumers.",
+          "stability": "stable",
+          "summary": "Constructs a new Event Hub Cluster."
         },
         "locationInModule": {
           "filename": "src/azure-eventhub/lib/cluster.ts",
-          "line": 29
+          "line": 58
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, usually representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique name for this instance of the Event Hub Cluster."
+            },
             "name": "name",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n- `resourceGroup`: Required. The Azure Resource Group in which the cluster will be deployed.\n- `name`: Required. The name of the Event Hub Cluster.\n- `skuName`: Optional. The SKU name for the cluster, which determines the pricing and capabilities.\n      Currently, the only supported value is \"Dedicated_1\". Defaults to \"Dedicated_1\" if not specified.\n- `tags`: Optional. Tags for resource management and categorization.\n\nExample usage:\n```typescript\nconst eventHubCluster = new Cluster(this, 'myEventHubCluster', {\nresourceGroup: resourceGroup,\nname: 'myCluster',\nskuName: 'Dedicated_1', // This is optional since it defaults to 'Dedicated_1'\ntags: {\ndepartment: 'IT'\n}\n});\n```",
+              "summary": "- The properties for configuring the Event Hub Cluster."
+            },
             "name": "ehClusterProps",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.ClusterProps"
@@ -3730,26 +3800,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.ConsumerGroup",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "An Event Hub Consumer Group is a view of an entire Event Hub that enables consumer applications to each have\na separate view of the event stream. They read the stream independently at their own pace and with their own\noffsets. This class creates a consumer group for a specified Event Hub, allowing for decentralized and\nscalable event processing.",
+          "stability": "stable",
+          "summary": "Constructs a new Event Hub Consumer Group."
         },
         "locationInModule": {
           "filename": "src/azure-eventhub/lib/consumer.ts",
-          "line": 30
+          "line": 58
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique name for this instance of the Consumer Group."
+            },
             "name": "name",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n- `name`: Required. The name of the Consumer Group.\n- `resourceGroup`: Required. The Azure Resource Group in which the Consumer Group's grandparent Namespace exists.\n- `namespaceName`: Required. The name of the grandparent EventHub Namespace.\n- `eventhubName`: Required. The name of the Event Hub for which the consumer group is created.\n- `userMetadata`: Optional. User-defined metadata to provide additional context about the Consumer Group.\n\nExample usage:\n```typescript\nconst consumerGroup = new ConsumerGroup(this, 'myConsumerGroup', {\nresourceGroup: resourceGroup,\nnamespaceName: 'exampleNamespace',\neventhubName: 'exampleEventHub',\nname: 'myConsumerGroupName',\nuserMetadata: 'Information about consumer group'\n});\n```",
+              "summary": "- The properties for configuring the Consumer Group."
+            },
             "name": "ehConsumerGroupProps",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.ConsumerGroupProps"
@@ -3903,26 +3985,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.Instance",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class creates an Azure Event Hub instance within a specified namespace. Event Hubs is a highly scalable\ndata streaming platform and event ingestion service, capable of receiving and processing millions of events per second.\nEvent Hubs can process and store events, data, or telemetry produced by distributed software and devices.",
+          "stability": "stable",
+          "summary": "Constructs a new Event Hub instance."
         },
         "locationInModule": {
           "filename": "src/azure-eventhub/lib/instance.ts",
-          "line": 56
+          "line": 85
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically used for managing lifecycles and creation order."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique name for this instance of the Event Hub."
+            },
             "name": "name",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "The properties include:\n- `name`: Required. The name of the Event Hub instance.\n- `partitionCount`: Optional. The number of partitions for the Event Hub. Defaults to 2. Max value is 32 for shared namespaces.\n- `messageRetention`: Optional. The number of days to retain the messages. Defaults to 1.\n- `status`: Optional. Specifies the operational status of the Event Hub (Active, Disabled, SendDisabled). Defaults to \"Active\".\n- `resourceGroup`: Required. The name of the resource group in which the Event Hub's parent namespace exists.\n- `namespaceName`: Required. The name of the Event Hub Namespace where this instance will be created.\n\nExample usage:\n```typescript\nconst eventHubInstance = new Instance(this, 'myEventHubInstance', {\nname: 'exampleEventHub',\nnamespaceName: 'exampleNamespace',\nresourceGroup: resourceGroup,\npartitionCount: 4,\nmessageRetention: 7,\nstatus: 'Active'\n});\n```",
+              "summary": "- The properties for configuring the Event Hub instance."
+            },
             "name": "ehInstanceProps",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.InstanceProps"
@@ -3938,15 +4032,22 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method creates a new Authorization Rule associated with the specified Event Hub,\ngranting specified permissions such as 'listen', 'send', and 'manage' based on the properties provided.\nThe rule determines the access level granted to users and applications for the Event Hub.",
+            "returns": "An instance of the AuthorizationRule class, configured with the specified permissions and associated\nwith the Event Hub specified in the enclosing construct's properties.\n\nExample usage:\n```typescript\nconst eventHubAuthRule = eventHubInstance.addAuthorizationRule({\nname: 'myCustomAuthRule',\nlisten: true,\nsend: true,\nmanage: false // Only listening and sending permissions are granted.\n});\n```",
+            "stability": "stable",
+            "summary": "Adds an Authorization Rule to an Event Hub instance."
           },
           "locationInModule": {
             "filename": "src/azure-eventhub/lib/instance.ts",
-            "line": 100
+            "line": 156
           },
           "name": "addAuthorizationRule",
           "parameters": [
             {
+              "docs": {
+                "remarks": "A unique identifier for the Authorization Rule within the Event Hub.\n  - `listen`: Optional. Specifies if the rule allows listening to the Event Hub. Defaults to false.\n  - `send`: Optional. Specifies if the rule allows sending events to the Event Hub. Defaults to false.\n  - `manage`: Optional. Specifies if the rule allows managing the Event Hub. When set to true,\n              both 'listen' and 'send' are implicitly enabled. Defaults to false.",
+                "summary": "- The properties for the Authorization Rule, which include:   - `name`: Required."
+              },
               "name": "props",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.AuthorizationRuleProps"
@@ -3961,21 +4062,35 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "custom": {
+              "remarks": "Each consumer group can have multiple concurrent readers, but each partition in the Event Hub can only have one active consumer\nfrom a specific consumer group at a time. Multiple consumer groups enable multiple consuming applications to each have a separate\nview of the event stream, and to read the stream independently at their own pace and with their own offsets."
+            },
+            "remarks": "This method creates a new Consumer Group for the specified Event Hub. Consumer groups represent a view of the entire Event Hub,\nallowing consumer applications to have separate, independent views of the event stream. They read the stream at their own pace\nand maintain their own sequence point or offset. This enables a single Event Hub to support multiple consumer applications.",
+            "returns": "An instance of the ConsumerGroup class, configured with the specified properties and associated with the Event Hub\nspecified in the enclosing construct's properties.\n\nExample usage:\n```typescript\nconst myConsumerGroup = eventHubInstance.addConsumerGroup('myConsumerGroupName', 'Metadata about this consumer group');\n```",
+            "stability": "stable",
+            "summary": "Adds a Consumer Group to an existing Event Hub instance."
           },
           "locationInModule": {
             "filename": "src/azure-eventhub/lib/instance.ts",
-            "line": 109
+            "line": 189
           },
           "name": "addConsumerGroup",
           "parameters": [
             {
+              "docs": {
+                "remarks": "This name must be unique within the Event Hub namespace.",
+                "summary": "- The name of the Consumer Group to be added."
+              },
               "name": "name",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "User-defined metadata for the Consumer Group. This metadata is useful for storing additional\n  information about the consumer group, such as its purpose or operational details.",
+                "summary": "- Optional."
+              },
               "name": "userMetadata",
               "optional": true,
               "type": {
@@ -3991,15 +4106,22 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method configures a new Kusto Data Connection linked to the specified EventHub. It facilitates the ingestion of streaming data\ninto the Kusto database, allowing for real-time analytics on streamed data. This connection specifies how data from EventHub\nis to be ingested into tables within the Kusto Database.",
+            "returns": "An instance of the KustoDataConnection class, configured with the specified properties and linked to the EventHub\nspecified in the enclosing construct's properties.\n\nExample usage:\n```typescript\nconst kustoConnection = kustoInstance.addKustoDataConnection({\nname: 'myKustoDataConnection',\nlocation: 'West US',\nkustoResourceGroup: resourceGroup,\nkustoClusterName: 'myCluster',\nkustoDatabaseName: 'myDatabase',\ntableName: 'IngestionTable',\nconsumerGroup: '$Default',\ndataFormat: 'JSON'\n});\n```",
+            "stability": "stable",
+            "summary": "Adds a Kusto Data Connection to an existing Kusto Cluster and Database for ingesting data from an EventHub."
           },
           "locationInModule": {
             "filename": "src/azure-eventhub/lib/instance.ts",
-            "line": 119
+            "line": 237
           },
           "name": "addKustoDataConnection",
           "parameters": [
             {
+              "docs": {
+                "remarks": "The name of the data connection to create.\n  - `location`: Required. The Azure region where the data connection will be created.\n  - `kustoResourceGroup`: Required. The Resource Group where the Kusto database exists.\n  - `kustoClusterName`: Required. The name of the Kusto Cluster to which this data connection will be added.\n  - `kustoDatabaseName`: Required. The name of the Kusto Database to which this data connection will be added.\n  - `consumerGroup`: Optional. The EventHub consumer group used for ingestion. Defaults to \"$Default\".\n  - `tableName`: Optional. The target table name in the Kusto database used for data ingestion.\n  - `identityId`: Optional. The resource ID of a managed identity used for authentication with EventHub.\n  - `mappingRuleName`: Optional. The mapping rule name used for data ingestion.\n  - `dataFormat`: Optional. Specifies the data format of EventHub messages. Defaults to \"JSON\".\n  - `databaseRoutingType`: Optional. Indicates the routing type for the database. Defaults to \"Single\".\n  - `compression`: Optional. Specifies the compression type for the data connection. Defaults to \"None\".",
+                "summary": "- The properties for the Kusto Data Connection, derived from BaseKustoDataConnectionProps, which include:   - `name`: Required."
+              },
               "name": "props",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.BaseKustoDataConnectionProps"
@@ -4128,26 +4250,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.KustoDataConnection",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class creates a data connection within a specified Kusto (Azure Data Explorer) database that connects\nto an Azure EventHub. This setup enables seamless data ingestion from EventHub into the Kusto database,\nallowing for real-time analytics on streamed data.",
+          "stability": "stable",
+          "summary": "Constructs a new Azure Kusto Data Connection for ingesting data from an EventHub."
         },
         "locationInModule": {
           "filename": "src/azure-eventhub/lib/kusto-connection.ts",
-          "line": 83
+          "line": 124
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the data connection."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n- `name`: Required. The name of the data connection.\n- `location`: Required. The Azure region where the data connection will be created.\n- `kustoResourceGroup`: Required. The Resource Group where the Kusto database exists.\n- `kustoClusterName`: Required. The name of the Kusto Cluster to which this data connection will be added.\n- `kustoDatabaseName`: Required. The name of the Kusto Database to which this data connection will be added.\n- `eventhubId`: Required. The resource ID of the EventHub used for data ingestion.\n- `consumerGroup`: Optional. The EventHub consumer group used for ingestion. Defaults to \"$Default\".\n- `tableName`: Optional. The target table name in the Kusto database used for data ingestion.\n- `identityId`: Optional. The resource ID of a managed identity used for authentication with EventHub.\n- `mappingRuleName`: Optional. The mapping rule name used for data ingestion.\n- `dataFormat`: Optional. Specifies the data format of EventHub messages. Defaults to \"JSON\".\n- `databaseRoutingType`: Optional. Indicates the routing type for the database. Defaults to \"Single\".\n- `compression`: Optional. Specifies the compression type for the data connection. Defaults to \"None\".\n\nExample usage:\n```typescript\nconst kustoDataConnection = new KustoDataConnection(this, 'myDataConnection', {\nname: 'exampleDataConnection',\nlocation: 'East US',\nkustoResourceGroup: resourceGroup,\nkustoClusterName: 'exampleCluster',\nkustoDatabaseName: 'exampleDatabase',\neventhubId: '/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.EventHub/namespaces/{namespace}/eventhubs/{eventhub}',\nconsumerGroup: '$Default',\ntableName: 'destinationTable',\ndataFormat: 'JSON',\ndatabaseRoutingType: 'Single',\ncompression: 'None'\n});\n```",
+              "summary": "- The properties for configuring the Kusto EventHub Data Connection."
+            },
             "name": "kustoDataConnectionProps",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.KustoDataConnectionProps"
@@ -4226,26 +4360,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.Namespace",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class creates an Azure Event Hub Namespace, which serves as a container for all messaging components.\nNamespaces provide a scoping container for Event Hub resources within a specific region, which can be further\ncontrolled and managed using the provided settings.",
+          "stability": "stable",
+          "summary": "Constructs a new Event Hub Namespace."
         },
         "locationInModule": {
           "filename": "src/azure-eventhub/lib/namespace.ts",
-          "line": 82
+          "line": 126
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique name for this instance of the Event Hub Namespace."
+            },
             "name": "name",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n- `resourceGroup`: Required. The Azure Resource Group in which the namespace will be created.\n- `name`: Required. The name of the Event Hub Namespace to create.\n- `sku`: Optional. The SKU tier of the namespace (Basic, Standard, Premium). Defaults to \"Basic\".\n- `capacity`: Optional. Specifies the throughput units for a Standard SKU namespace. Defaults to 2.\n- `autoInflateEnabled`: Optional. Enables or disables Auto Inflate. Defaults to false.\n- `maximumThroughputUnits`: Optional. The maximum number of throughput units when Auto Inflate is enabled. Defaults to 2.\n- `zoneRedundant`: Optional. Specifies if the namespace should be zone redundant. Defaults to true.\n- `tags`: Optional. Tags for resource management and categorization.\n- `minimumTlsVersion`: Optional. Specifies the minimum supported TLS version. Defaults to \"1.2\".\n- `publicNetworkAccessEnabled`: Optional. Specifies if public network access is enabled. Defaults to true.\n- `localAuthenticationEnabled`: Optional. Specifies if SAS authentication is enabled. Defaults to false.\n- `identityType`: Optional. The type of Managed Service Identity. Defaults to \"SystemAssigned\".\n- `identityIds`: Optional. A list of User Assigned Managed Identity IDs.\n\nExample usage:\n```typescript\nconst eventHubNamespace = new Namespace(this, 'myNamespace', {\nresourceGroup: resourceGroup,\nname: 'myEventHubNamespace',\nsku: 'Standard',\ncapacity: 4,\nautoInflateEnabled: true,\nmaximumThroughputUnits: 10,\nzoneRedundant: false,\ntags: {\ndepartment: 'IT'\n},\nminimumTlsVersion: '1.2',\npublicNetworkAccessEnabled: false,\nlocalAuthenticationEnabled: true,\nidentityType: 'SystemAssigned'\n});\n```",
+              "summary": "- The properties for configuring the Event Hub Namespace."
+            },
             "name": "ehNamespaceProps",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.NamespaceProps"
@@ -4261,15 +4407,25 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "custom": {
+              "remarks": "Ensure that the namespace has sufficient capacity and configuration to support the properties of the Event Hub being created,\nespecially in terms of partition count and throughput units if applicable."
+            },
+            "remarks": "This method sets up a new Event Hub instance within the namespace defined by this class. An Event Hub instance\nserves as a container that processes and stores events. This method facilitates the setup of multiple Event Hubs\nwithin a single namespace, each configured according to the specified properties.",
+            "returns": "An instance of the Event Hub (`Instance` class), configured with the specified properties.\n\nExample usage:\n```typescript\nconst eventHub = namespace.addEventhubInstance({\nname: 'myEventHub',\npartitionCount: 4,\nmessageRetention: 7,\nstatus: 'Active'\n});\n```",
+            "stability": "stable",
+            "summary": "Creates and adds an Event Hub instance to the current namespace."
           },
           "locationInModule": {
             "filename": "src/azure-eventhub/lib/namespace.ts",
-            "line": 134
+            "line": 207
           },
           "name": "addEventhubInstance",
           "parameters": [
             {
+              "docs": {
+                "remarks": "These properties extend `BaseInstanceProps`, which include:\n  - `name`: Required. The name of the Event Hub instance.\n  - `partitionCount`: Optional. The number of partitions in the Event Hub. Default is 2.\n  - `messageRetention`: Optional. The number of days to retain messages in the Event Hub. Default is 1.\n  - `status`: Optional. The operational status of the Event Hub (Active, Disabled, SendDisabled). Default is \"Active\".\n  Other properties from `BaseInstanceProps` can also be passed and will be used in the creation of the Event Hub.",
+                "summary": "- The properties for configuring the new Event Hub instance."
+              },
               "name": "props",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.azure_eventhub.BaseInstanceProps"
@@ -5337,26 +5493,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.AccessPolicy",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for setting up access policies that define what operations an Azure AD identity\ncan perform on the keys, secrets, certificates, and storage accounts within a specified Azure Key Vault.",
+          "stability": "stable",
+          "summary": "Constructs a new Access Policy for Azure Key Vault."
         },
         "locationInModule": {
           "filename": "src/azure-keyvault/lib/policy.ts",
-          "line": 55
+          "line": 85
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, usually representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the access policy."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `keyVaultId`: The Azure Key Vault identifier where the policy will be set.\n  - `tenantId`: The tenant ID of the Azure AD tenant where the Key Vault is hosted.\n  - `objectId`: The object ID of the Azure AD identity (user, group, or service principal).\n  - `secretPermissions`: Optional list of permissions to secrets within the Key Vault.\n  - `certificatePermissions`: Optional list of permissions to certificates within the Key Vault.\n  - `keyPermissions`: Optional list of permissions to keys within the Key Vault.\n  - `storagePermissions`: Optional list of permissions to storage accounts linked to the Key Vault.\n\nExample usage:\n```typescript\nnew AccessPolicy(this, 'MyAccessPolicy', {\nkeyVaultId: myKeyVault,\ntenantId: 'my-tenant-id',\nobjectId: 'user-object-id',\nkeyPermissions: ['get', 'list', 'update'],\nsecretPermissions: ['get'],\ncertificatePermissions: ['get', 'list'],\nstoragePermissions: ['get', 'list']\n});\n```",
+              "summary": "- The properties for creating the access policy as defined in AccessPolicyProps."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.AccessPolicyProps"
@@ -5558,26 +5726,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.CertificateIssuer",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for setting up a certificate issuer in Azure Key Vault. A certificate issuer is an entity\nthat issues digital certificates for use in SSL/TLS and other cryptographic security contexts. By configuring an issuer,\nyou can manage certificate lifecycle (issue, renew, revoke) through Azure Key Vault in conjunction with external certificate\nauthorities (CAs).",
+          "stability": "stable",
+          "summary": "Constructs a new Certificate Issuer within an Azure Key Vault."
         },
         "locationInModule": {
           "filename": "src/azure-keyvault/lib/certificate.ts",
-          "line": 122
+          "line": 216
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, usually representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the certificate issuer."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n  - `name`: Required. The name of the issuer as it will appear in Azure Key Vault.\n  - `providerName`: Required. The name of the provider that will issue the certificates, such as 'DigiCert' or 'GlobalSign'.\n  - `keyVaultId`: Required. The ID of the Azure Key Vault where the issuer will be configured.\n  - `accessPolicies`: Required. Access policies defining who can manage this issuer within the Key Vault.\n  - `username`: Optional. The username required to authenticate with the certificate provider (if applicable).\n  - `password`: Optional. The password required to authenticate with the certificate provider (if applicable).\n\nExample usage:\n```typescript\nnew CertificateIssuer(this, 'MyCertIssuer', {\nname: 'MyIssuer',\nproviderName: 'DigiCert',\nkeyVaultId: myKeyVault,\naccessPolicies: [{ userId: 'user123', permissions: ['manageIssuer'] }],\nusername: 'user@example.com',\npassword: 'securepassword'\n});\n```",
+              "summary": "- The properties for configuring the certificate issuer as defined in CertificateIssuerProps."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.CertificateIssuerProps"
@@ -5588,7 +5768,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/azure-keyvault/lib/certificate.ts",
-        "line": 121
+        "line": 185
       },
       "name": "CertificateIssuer",
       "namespace": "azure_keyvault",
@@ -5598,13 +5778,14 @@
       "assembly": "@microsoft/terraform-cdk-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Properties required to configure a certificate issuer within Azure Key Vault."
       },
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.CertificateIssuerProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/azure-keyvault/lib/certificate.ts",
-        "line": 28
+        "line": 55
       },
       "name": "CertificateIssuerProps",
       "namespace": "azure_keyvault",
@@ -5612,12 +5793,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Access policies defining who can manage this issuer and the certificates it issues within the Key Vault."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 38
+            "line": 74
           },
           "name": "accessPolicies",
           "type": {
@@ -5632,12 +5814,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The ID of the Azure Key Vault where the issuer will be configured."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 36
+            "line": 69
           },
           "name": "keyVaultId",
           "type": {
@@ -5648,12 +5831,12 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "The name of the certificate issuer in the Azure Key Vault."
+            "summary": "The name of the certificate issuer as it will appear in Azure Key Vault."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 32
+            "line": 59
           },
           "name": "name",
           "type": {
@@ -5663,12 +5846,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The name of the provider that will issue the certificate, such as 'DigiCert' or 'GlobalSign'."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 34
+            "line": 64
           },
           "name": "providerName",
           "type": {
@@ -5678,12 +5862,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The password required to authenticate with the certificate provider (if applicable)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 42
+            "line": 84
           },
           "name": "password",
           "optional": true,
@@ -5694,12 +5879,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The username required to authenticate with the certificate provider (if applicable)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 40
+            "line": 79
           },
           "name": "username",
           "optional": true,
@@ -5830,26 +6016,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.Key",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of a cryptographic key stored in Azure Key Vault.\nThe key can be used for a variety of cryptographic operations, such as encryption, decryption, signing, or\nverifying signatures, depending on the permissions granted. It supports different key types and configurations,\nallowing for customization to meet specific security requirements.",
+          "stability": "stable",
+          "summary": "Constructs a new Key resource in Azure Key Vault."
         },
         "locationInModule": {
           "filename": "src/azure-keyvault/lib/key.ts",
-          "line": 48
+          "line": 84
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, usually representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the Key."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n  - `name`: Required. The name of the key as it will appear in Azure Key Vault.\n  - `keyVaultId`: Required. The ID of the Azure Key Vault where the key will be created.\n  - `keyType`: Required. The type of cryptographic key to create (e.g., RSA, EC).\n  - `keySize`: Optional. The size of the key, typically specified for RSA keys.\n  - `keyOpts`: Optional. Additional options or attributes related to the key's capabilities such as encrypt, decrypt, wrapKey, unwrapKey.\n  - `rotationPolicy`: Optional. The policy settings for rotating the key automatically.\n  - `expires`: Optional. The expiration date of the key in UTC format (YYYY-MM-DDTHH:MM:SSZ).\n  - `accessPolicies`: Required. Access policies defining who can access this key within the Key Vault.\n\nExample usage:\n```typescript\nnew Key(this, 'myKey', {\nname: 'encryptionKey',\nkeyVaultId: myKeyVault,\nkeyType: 'RSA',\nkeySize: 2048,\nkeyOpts: ['encrypt', 'decrypt', 'sign', 'verify'],\nrotationPolicy: {\nexpiryTime: 'P90D'\n},\nexpires: '2030-01-01T00:00:00Z',\naccessPolicies: [{ userId: 'user123', permissions: ['get', 'list', 'update'] }]\n});\n```",
+              "summary": "- The properties for creating the key as defined in KeyProps."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.KeyProps"
@@ -6048,26 +6246,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.Secret",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class facilitates the creation and management of a secret, allowing sensitive information to be stored securely\nand accessed as needed while maintaining confidentiality and control through defined access policies.",
+          "stability": "stable",
+          "summary": "Constructs a new Azure Key Vault Secret within a specified Key Vault."
         },
         "locationInModule": {
           "filename": "src/azure-keyvault/lib/secret.ts",
-          "line": 47
+          "line": 78
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the secret."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `keyVaultId`: The ID of the Key Vault in which to store the secret.\n  - `name`: The name of the secret.\n  - `value`: The confidential data to be stored as the secret.\n  - `expirationDate`: Optional. The expiration date of the secret.\n  - `contentType`: Optional. A label hinting at the content type of the secret's value.\n  - `accessPolicies`: Access policies that dictate permissions for the secret.\n\nExample usage:\n```typescript\nnew Secret(this, 'mySecret', {\nkeyVaultId: myKeyVault,\nname: 'dbPassword',\nvalue: 'p@ssw0rd!',\nexpirationDate: '2030-01-01T00:00:00Z',\ncontentType: 'password',\naccessPolicies: [{\nobjectId: '12345-user-object-id',\npermissions: ['get', 'list']\n}]\n});\n```",
+              "summary": "- The properties for creating the secret as defined in SecretProps."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.SecretProps"
@@ -6235,26 +6445,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.SelfSignedCertificate",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of a self-signed certificate, making it available\nwithin an Azure Key Vault. The certificate can be used for testing or internal secure communications.",
+          "stability": "stable",
+          "summary": "Constructs a self-signed certificate within an Azure Key Vault."
         },
         "locationInModule": {
           "filename": "src/azure-keyvault/lib/certificate.ts",
-          "line": 50
+          "line": 114
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, usually representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the certificate."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "Example usage:\n```typescript\nnew SelfSignedCertificate(this, 'MySelfSignedCert', {\nname: 'exampleCert',\nsubject: 'CN=example.com',\ndnsNames: ['example.com', 'www.example.com'],\nkeyVaultId: myKeyVault,\naccessPolicies: [{ userId: 'user123', permissions: ['all'] }],\ntags: { project: 'My Project' }\n});\n```",
+              "summary": "- The properties for creating the self-signed certificate as defined in SelfSignedCertificateProps."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.SelfSignedCertificateProps"
@@ -6265,7 +6487,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/azure-keyvault/lib/certificate.ts",
-        "line": 45
+        "line": 87
       },
       "name": "SelfSignedCertificate",
       "namespace": "azure_keyvault",
@@ -6276,7 +6498,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 46
+            "line": 88
           },
           "name": "certificate",
           "type": {
@@ -6289,7 +6511,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 47
+            "line": 89
           },
           "name": "id",
           "type": {
@@ -6302,7 +6524,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 48
+            "line": 90
           },
           "name": "secretId",
           "type": {
@@ -6316,13 +6538,14 @@
       "assembly": "@microsoft/terraform-cdk-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Properties required to create a self-signed certificate within Azure Key Vault."
       },
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.SelfSignedCertificateProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/azure-keyvault/lib/certificate.ts",
-        "line": 7
+        "line": 10
       },
       "name": "SelfSignedCertificateProps",
       "namespace": "azure_keyvault",
@@ -6330,12 +6553,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Access policies defining who can access this certificate within the Azure Key Vault."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 23
+            "line": 44
           },
           "name": "accessPolicies",
           "type": {
@@ -6350,12 +6574,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "remarks": "Useful for creating certificates valid for multiple hostnames.",
+            "stability": "stable",
+            "summary": "Additional DNS names to be included in the certificate."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 15
+            "line": 24
           },
           "name": "dnsNames",
           "type": {
@@ -6370,12 +6596,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The ID of the Azure Key Vault where the certificate will be created and stored."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 17
+            "line": 29
           },
           "name": "keyVaultId",
           "type": {
@@ -6386,12 +6613,12 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "The name of the certificate in the Azure Key Vault."
+            "summary": "The name of the certificate to be stored in Azure Key Vault."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 11
+            "line": 14
           },
           "name": "name",
           "type": {
@@ -6401,12 +6628,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The subject name for the certificate, typically represented in X.509 distinguished name format."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 13
+            "line": 19
           },
           "name": "subject",
           "type": {
@@ -6416,12 +6644,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Specifies the type of action to perform with the certificate, such as 'create' or 'renew'."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 19
+            "line": 34
           },
           "name": "actionType",
           "optional": true,
@@ -6432,12 +6661,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Specifies the number of days before expiry when an action should be taken (e.g., renew the certificate)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 21
+            "line": 39
           },
           "name": "daysBeforeExpiry",
           "optional": true,
@@ -6448,12 +6678,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Tags to be associated with the certificate for organizational purposes."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/certificate.ts",
-            "line": 25
+            "line": 49
           },
           "name": "tags",
           "optional": true,
@@ -6478,26 +6709,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.Vault",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class creates and configures an Azure Key Vault, a secure store for managing secrets, keys, certificates, and other sensitive data.\nIt supports advanced configurations such as access policies, network rules, and data retention policies.",
+          "stability": "stable",
+          "summary": "Constructs a new Azure Key Vault resource."
         },
         "locationInModule": {
           "filename": "src/azure-keyvault/lib/vault.ts",
-          "line": 102
+          "line": 128
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, usually representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the Key Vault."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include settings for location, SKU, tenant ID, etc.\n\nExample usage:\n```typescript\nnew Vault(this, 'MyKeyVault', {\nname: 'mySecureVault',\nlocation: 'East US',\nresourceGroup: myResourceGroup,\nsku: 'premium',\ntenantId: 'my-tenant-id',\nsoftDeleteRetentionDays: 90,\npurgeProtection: true,\ntags: {\nproject: 'My Application'\n}\n});\n```",
+              "summary": "- The properties for creating the Key Vault as defined in VaultProps."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.VaultProps"
@@ -6513,21 +6756,30 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method configures a certificate issuer within the Key Vault, allowing the Key Vault to issue certificates\nthrough external providers. Configuring an issuer is essential for enabling automated certificate management\nprocesses, such as issuance and renewal, directly through the Key Vault with a specified Certificate Authority (CA).",
+            "stability": "stable",
+            "summary": "Adds a certificate issuer to the Azure Key Vault."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 372
+            "line": 555
           },
           "name": "addCertIssuer",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The unique name for the certificate issuer within the Key Vault."
+              },
               "name": "name",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "Example usage:\n```typescript\nvault.addCertIssuer(\n'myCertIssuer',\n'DigiCert'\n);\n```\nThis method configures a certificate issuer but does not return any value. The issuer details, including provider name\nand any necessary credentials (managed externally or through additional method parameters), are set up in the Key Vault\nfor future certificate operations.",
+                "summary": "- The name of the external provider that will issue the certificates, such as 'DigiCert' or 'GlobalSign'."
+              },
               "name": "provider",
               "type": {
                 "primitive": "string"
@@ -6537,33 +6789,49 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method allows the creation of a cryptographic key of specified type and size within the Key Vault. The key can be\nconfigured with specific operations it can perform, such as encryption, decryption, signing, etc. An optional expiration\ndate can also be set to control the key's lifecycle. This method is flexible, supporting various key types and sizes,\nmaking it suitable for a wide range of cryptographic needs.",
+            "returns": "A KeyVaultKey object representing the newly created cryptographic key within the vault.\n\nExample usage:\n```typescript\nconst myKey = vault.addKey(\n'myKey',\n'RSA',\n2048,\n['encrypt', 'decrypt', 'sign', 'verify'],\n'2030-12-31'\n);\n```\nThis method returns the created KeyVaultKey object, enabling immediate use within the application for cryptographic operations.",
+            "stability": "stable",
+            "summary": "Creates a cryptographic key within the Azure Key Vault."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 329
+            "line": 465
           },
           "name": "addKey",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The unique name for the cryptographic key within the Key Vault."
+              },
               "name": "keyVaultKeyName",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "- The type of cryptographic key to create (e.g., 'RSA', 'EC', 'oct-HSM')."
+              },
               "name": "keyType",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "- The size of the cryptographic key in bits (e.g., 2048, 3072, 4096 for RSA)."
+              },
               "name": "keySize",
               "type": {
                 "primitive": "number"
               }
             },
             {
+              "docs": {
+                "remarks": "Possible values might include\n  'encrypt', 'decrypt', 'sign', 'verify', 'wrapKey', 'unwrapKey'.",
+                "summary": "- A list of cryptographic operations that the key is allowed to perform."
+              },
               "name": "keyOpts",
               "type": {
                 "collection": {
@@ -6575,6 +6843,10 @@
               }
             },
             {
+              "docs": {
+                "remarks": "The expiration date of the key in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ).\n  If provided, the key will no longer be valid after this date, aligning with best practices for key management.",
+                "summary": "- Optional."
+              },
               "name": "expirationDate",
               "optional": true,
               "type": {
@@ -6590,21 +6862,31 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method facilitates the creation of an RSA key, which is useful for a variety of cryptographic operations such as\nencryption, decryption, digital signature verification, and more. The RSA key created by this method is configurable\nwith an optional expiration date and a default key size of 2048 bits. The key operations allowed include decryption,\nencryption, signing, verifying signatures, and key wrapping/unwrapping.",
+            "returns": "A KeyVaultKey object representing the newly created RSA key within the vault.\n\nExample usage:\n```typescript\nconst rsaKey = vault.addRSAKey(\n'myRSAKey',\n'2030-01-01'\n);\n```\nThis method returns the created KeyVaultKey object, allowing further operations or references to the key.",
+            "stability": "stable",
+            "summary": "Creates an RSA cryptographic key within the Azure Key Vault."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 311
+            "line": 418
           },
           "name": "addRSAKey",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The unique name for the RSA key within the Key Vault."
+              },
               "name": "keyVaultKeyName",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "The expiration date of the key in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ).\n  If provided, the key will no longer be valid after this date.",
+                "summary": "- Optional."
+              },
               "name": "expirationDate",
               "optional": true,
               "type": {
@@ -6620,27 +6902,39 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method facilitates the storage of sensitive information in the form of a secret within the Key Vault.\nSecrets are protected items such as passwords, database connection strings, or any other piece of information\nthat needs to be securely stored and accessed. This method allows setting additional properties such as\nexpiration date and content type for better management and compliance.",
+            "stability": "stable",
+            "summary": "Creates a new secret within the Azure Key Vault."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 292
+            "line": 378
           },
           "name": "addSecret",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The unique name for the secret within the Key Vault."
+              },
               "name": "keyVaultSecretName",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "- The sensitive information or data that needs to be securely stored as a secret."
+              },
               "name": "secretValue",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "The expiration date of the secret in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ).\n  If provided, the secret will no longer be valid after this date.",
+                "summary": "- Optional."
+              },
               "name": "expirationDate",
               "optional": true,
               "type": {
@@ -6648,6 +6942,10 @@
               }
             },
             {
+              "docs": {
+                "remarks": "A description of the type of information the secret contains (e.g., 'password', 'connectionString').\n  This can be used by applications to handle the secret appropriately.\n\nExample usage:\n```typescript\nvault.addSecret(\n'myDatabasePassword',\n'p@ssw0rd123!',\n'2030-01-01',\n'databasePassword'\n);\n```\nThis method does not return a value. It creates a secret within the Key Vault with the specified properties.",
+                "summary": "- Optional."
+              },
               "name": "contentType",
               "optional": true,
               "type": {
@@ -6658,27 +6956,40 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method facilitates the creation of a self-signed certificate, which is a digital certificate that is signed by\nits own creator rather than a trusted authority. Self-signed certificates can be useful for testing, internal\ncommunications, or any scenario where public trust is not required. The method allows specifying subject details,\nDNS names for the certificate, and managing its lifecycle with action types and expiry.",
+            "returns": "A KeyVaultCertificate object representing the newly created self-signed certificate.\n\nExample usage:\n```typescript\nconst myCertificate = vault.addSelfSignedCert(\n'myCert',\n'CN=mydomain.com',\n['mydomain.com', 'www.mydomain.com'],\n'create',\n30\n);\n```\nThis method returns the KeyVaultCertificate object, enabling it to be used immediately within the application or stored for future use.",
+            "stability": "stable",
+            "summary": "Creates a self-signed certificate within the Azure Key Vault."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 352
+            "line": 514
           },
           "name": "addSelfSignedCert",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The unique name for the certificate within the Key Vault."
+              },
               "name": "certName",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "- The subject name of the certificate, typically formatted as an X.500 Distinguished Name (e.g., \"CN=example.com\")."
+              },
               "name": "subject",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "This is useful for certificates\n  that need to be valid for multiple hostnames.",
+                "summary": "- An array of DNS names that should be associated with this certificate."
+              },
               "name": "dnsNames",
               "type": {
                 "collection": {
@@ -6690,6 +7001,10 @@
               }
             },
             {
+              "docs": {
+                "remarks": "Specifies the action to be performed with the certificate, such as 'create' or 'renew'.",
+                "summary": "- Optional."
+              },
               "name": "actionType",
               "optional": true,
               "type": {
@@ -6697,6 +7012,10 @@
               }
             },
             {
+              "docs": {
+                "remarks": "Number of days before expiry when an action should be taken, useful for auto-renewal scenarios.",
+                "summary": "- Optional."
+              },
               "name": "daysBeforeExpiry",
               "optional": true,
               "type": {
@@ -6712,15 +7031,19 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Grants administrative access to certificates stored in the Key Vault to a specified Azure AD group."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 192
+            "line": 232
           },
           "name": "grantCertAdminAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The Azure Active Directory group ID that will receive administrative access to certificates."
+              },
               "name": "azureAdGroupId",
               "type": {
                 "primitive": "string"
@@ -6730,15 +7053,19 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Grants read-only access to certificates stored in the Key Vault to a specified Azure AD group."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 216
+            "line": 261
           },
           "name": "grantCertReaderAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The Azure Active Directory group ID that will receive read access to certificates."
+              },
               "name": "azureAdGroupId",
               "type": {
                 "primitive": "string"
@@ -6748,21 +7075,28 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Grants custom access based on specified options to an Azure AD group in the Key Vault."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 272
+            "line": 333
           },
           "name": "grantCustomAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The Azure Active Directory group ID that will receive the custom access."
+              },
               "name": "azureAdGroupId",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "- Custom access options specifying various permissions for secrets, keys, certificates, and storage."
+              },
               "name": "options",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.azure_keyvault.GrantCustomAccessOptions"
@@ -6772,15 +7106,19 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Grants administrative access to keys stored in the Key Vault to a specified Azure AD group."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 232
+            "line": 282
           },
           "name": "grantKeyAdminAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The Azure Active Directory group ID that will receive administrative access to keys."
+              },
               "name": "azureAdGroupId",
               "type": {
                 "primitive": "string"
@@ -6790,15 +7128,19 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Grants read-only access to keys stored in the Key Vault to a specified Azure AD group."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 256
+            "line": 311
           },
           "name": "grantKeyReaderAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The Azure Active Directory group ID that will receive read access to keys."
+              },
               "name": "azureAdGroupId",
               "type": {
                 "primitive": "string"
@@ -6808,15 +7150,19 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Grants administrative access to secrets stored in the Key Vault to a specified Azure AD group."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 168
+            "line": 203
           },
           "name": "grantSecretAdminAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The Azure Active Directory group ID that will receive administrative access to secrets."
+              },
               "name": "azureAdGroupId",
               "type": {
                 "primitive": "string"
@@ -6826,15 +7172,19 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Grants read-only access to secrets stored in the Key Vault to a specified Azure AD group."
           },
           "locationInModule": {
             "filename": "src/azure-keyvault/lib/vault.ts",
-            "line": 152
+            "line": 182
           },
           "name": "grantSecretReaderAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The Azure Active Directory group ID that will receive read access to secrets."
+              },
               "name": "azureAdGroupId",
               "type": {
                 "primitive": "string"
@@ -7089,17 +7439,18 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_kubernetes.Cluster",
       "initializer": {
         "docs": {
+          "remarks": "This class is responsible for the creation and management of an AKS cluster, allowing for the deployment and orchestration\nof containerized applications using Kubernetes within the Azure cloud platform.",
           "stability": "stable",
-          "summary": "Constructs a new AKS cluster."
+          "summary": "Represents an Azure Kubernetes Service (AKS) cluster resource in Azure."
         },
         "locationInModule": {
           "filename": "src/azure-kubernetes/lib/cluster.ts",
-          "line": 85
+          "line": 106
         },
         "parameters": [
           {
             "docs": {
-              "summary": "The scope in which to define this construct."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
             },
             "name": "scope",
             "type": {
@@ -7108,7 +7459,7 @@
           },
           {
             "docs": {
-              "summary": "The unique ID or name for this construct."
+              "summary": "- The unique identifier for this instance of the AKS cluster."
             },
             "name": "id",
             "type": {
@@ -7117,7 +7468,8 @@
           },
           {
             "docs": {
-              "summary": "The properties required to configure the AKS cluster."
+              "remarks": "Example usage:\n```typescript\nnew Cluster(this, 'MyAKSCluster', {\nname: 'example-cluster',\nlocation: 'East US',\ndefaultNodePool: {\nvmSize: 'Standard_D2_v3',\nnodeCount: 3,\ntype: 'VirtualMachineScaleSets'\n},\nresourceGroup: existingResourceGroup,\ntags: {\nenvironment: 'production'\n}\n});\n```",
+              "summary": "- The properties required to configure the AKS cluster, as defined in the ClusterProps interface."
             },
             "name": "props",
             "type": {
@@ -7344,26 +7696,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_kusto.Cluster",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of a Kusto Cluster, which is a highly scalable and secure\nanalytics service for ingesting, storing, and analyzing large volumes of data. The cluster supports various configurations\ntailored to the needs of specific data workloads and security requirements.",
+          "stability": "stable",
+          "summary": "Represents a Kusto (Azure Data Explorer) cluster in Azure."
         },
         "locationInModule": {
           "filename": "src/azure-kusto/lib/cluster.ts",
-          "line": 87
+          "line": 111
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the cluster."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "Example usage:\n```typescript\nnew Cluster(this, 'MyKustoCluster', {\nname: 'example-cluster',\nlocation: 'West US',\nresourceGroup: myResourceGroup,\nsku: { tier: 'Standard', name: 'D13_v2', capacity: 2 },\ntags: {\nproject: 'Data Analytics'\n}\n});\n```",
+              "summary": "- The properties required to configure the Kusto cluster, as defined in the ClusterProps interface."
+            },
             "name": "kustoProps",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_kusto.ClusterProps"
@@ -7379,15 +7743,22 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method creates a database within the Azure Data Explorer (Kusto) cluster, defined by the properties provided.\nA database in Kusto serves as a logical group to manage various tables and store data. It is essential for performing\ndata analytics and running queries. The database configuration can include settings like hot cache and soft delete periods,\nwhich optimize query performance and manage data lifecycle according to specific requirements.",
+            "returns": "A `Database` object representing the newly created database within the Kusto cluster.\n\nExample usage:\n```typescript\nconst myDatabase = myCluster.addDatabase({\nkusto: myKustoCluster,\nname: 'OperationalData',\nhotCachePeriod: 'P14D', // 14 days\nsoftDeletePeriod: 'P365D' // 1 year\n});\n```\nThis method facilitates the efficient setup and scaling of databases within an Azure Kusto cluster, allowing\nfor complex data analytics operations across large datasets.",
+            "stability": "stable",
+            "summary": "Adds a new database to the Azure Kusto Cluster."
           },
           "locationInModule": {
             "filename": "src/azure-kusto/lib/cluster.ts",
-            "line": 186
+            "line": 239
           },
           "name": "addDatabase",
           "parameters": [
             {
+              "docs": {
+                "remarks": "These properties should include:\n  - `kusto`: Reference to the Kusto cluster to which the database will be added.\n  - `name`: The name of the database, which must be unique within the cluster.\n  - `hotCachePeriod`: Optional. Specifies the duration that data should be kept in cache for faster query access.\n  - `softDeletePeriod`: Optional. Specifies the duration that data should be retained before it stops being accessible to queries.\n    Both the hot cache and soft delete periods should be specified in ISO 8601 duration format.",
+                "summary": "- The properties required to create the database."
+              },
               "name": "databaseProps",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.azure_kusto.DatabaseProps"
@@ -8598,26 +8969,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_kusto.Database",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of a database in Azure Data Explorer (Kusto),\nwhich stores data tables and provides a query engine. A Kusto database is a logical group of tables\nand is associated with a specific Kusto cluster. The database supports configurations such as\nhot cache period and soft delete period to optimize performance and data retention according to\nspecific workload requirements.",
+          "stability": "stable",
+          "summary": "Represents a Kusto Database within an Azure Kusto Cluster."
         },
         "locationInModule": {
           "filename": "src/azure-kusto/lib/database.ts",
-          "line": 65
+          "line": 97
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the Kusto database."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `kusto`: Reference to the Kusto cluster to which the database will belong.\n  - `name`: The name of the database to be created within the Kusto cluster.\n  - `hotCachePeriod`: Optional. Specifies the duration that data should be kept in cache for faster query performance.\n                      Expressed in ISO 8601 duration format.\n  - `softDeletePeriod`: Optional. Specifies the duration that data should be retained before it stops being accessible.\n                        Expressed in ISO 8601 duration format.\n\nExample usage:\n```typescript\nconst myDatabase = new Database(this, 'MyKustoDatabase', {\nkusto: myKustoCluster,\nname: 'AnalyticsDB',\nhotCachePeriod: 'P30D',  // 30 days\nsoftDeletePeriod: 'P365D' // 365 days\n});\n```\n\nThis class sets up the database configurations and integrates it within the specified Kusto cluster,\nproviding capabilities to manage and query large datasets effectively.",
+              "summary": "- The properties required to configure the Kusto database."
+            },
             "name": "kustoDbProps",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_kusto.DatabaseProps"
@@ -8633,15 +9016,21 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method is used to grant access permissions to a specific user, group, or service principal within an Azure Active Directory.\nThese permissions determine the level of access that the principal has over the Kusto database, such as viewing, ingesting, or managing data.\nThe assignment is made by creating a KustoDatabasePrincipalAssignment resource, specifying the principal details and the type of role\nthey should assume.",
+            "stability": "stable",
+            "summary": "Adds a database principal assignment in the Kusto cluster, assigning specified access rights to a principal."
           },
           "locationInModule": {
             "filename": "src/azure-kusto/lib/database.ts",
-            "line": 107
+            "line": 168
           },
           "name": "addPermission",
           "parameters": [
             {
+              "docs": {
+                "remarks": "This includes:\n- `name`: A unique name identifying this principal assignment.\n- `tenantId`: The Azure Active Directory tenant ID where the principal resides.\n- `principalId`: The object ID of the principal (user, group, or service principal) in Azure AD.\n- `principalType`: The type of principal (e.g., User, Group, App).\n- `role`: The database role assigned to the principal. Roles can include Admin, User, Viewer, among others.\n\nExample usage:\n```typescript\nmyDatabase.addPermission({\nname: 'DataScienceTeamAccess',\ntenantId: 'tenant-id',\nprincipalId: 'principal-id',\nprincipalType: 'Group',\nrole: 'Viewer'\n});\n```\nThis method creates a new principal assignment, enabling specified access controls for the principal\non the Kusto database based on the role assigned. It is crucial for managing security and access\ngovernance within the Kusto environment.",
+                "summary": "- The properties defining the principal assignment."
+              },
               "name": "kustoDatabaseAccessProps",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.azure_kusto.DatabaseAccessProps"
@@ -8651,21 +9040,30 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method facilitates the execution of Kusto Query Language (KQL) scripts or control commands within the specified\nKusto database. Scripts can perform a variety of functions, from schema modifications, like adding new tables or altering\nexisting ones, to data management operations, such as data ingestion or cleanup tasks. Each script is executed as a\nKustoScript resource, which ensures that the script is applied correctly and atomically to the database.",
+            "stability": "stable",
+            "summary": "Adds and executes a control command or script within the Kusto database."
           },
           "locationInModule": {
             "filename": "src/azure-kusto/lib/database.ts",
-            "line": 145
+            "line": 248
           },
           "name": "addScript",
           "parameters": [
             {
+              "docs": {
+                "summary": "- A unique name for the script, which helps in identifying the script resource within the deployment."
+              },
               "name": "scriptName",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "Example usage:\n```typescript\nmyDatabase.addScript('InitializeSalesTable', `\n.create table SalesData (TransactionId: int, TransactionDate: datetime, Amount: real)\n.alter-merge table SalesData policy retentionsoftdelete = 365d\n`);\n```\nThis method will create a `KustoScript` resource that encapsulates the command, ensuring it is executed against the\ndatabase, and is tracked as part of the resource management within Azure.",
+                "summary": "- The KQL script or control command to be executed. This should be a valid KQL command string."
+              },
               "name": "scriptContent",
               "type": {
                 "primitive": "string"
@@ -8675,21 +9073,30 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method creates a table within the specified Kusto database using a given schema. Tables in Kusto store structured data with\ndefined columns and types, which are crucial for storing and querying large datasets efficiently. The method constructs a Kusto\nData Explorer control command to create the table and then executes this command within the context of the database.",
+            "stability": "stable",
+            "summary": "Adds a new table to an existing Azure Kusto database."
           },
           "locationInModule": {
             "filename": "src/azure-kusto/lib/database.ts",
-            "line": 124
+            "line": 206
           },
           "name": "addTable",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The name of the table to create, which must be unique within the database."
+              },
               "name": "tableName",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "Example usage:\n```typescript\nmyDatabase.addTable('SalesData', [\n{ columnName: 'TransactionId', columnType: 'int' },\n{ columnName: 'TransactionDate', columnType: 'datetime' },\n{ columnName: 'Amount', columnType: 'real' }\n]);\n```\nThis method constructs the command to create the table and applies it directly within the Kusto database,\nensuring the table is ready for data ingestion and querying.",
+                "summary": "- An array of schema properties defining the columns of the table, including column names and their data types."
+              },
               "name": "tableSchema",
               "type": {
                 "collection": {
@@ -9417,26 +9824,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_loganalytics.Workspace",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and configuration of a Log Analytics Workspace in Azure. A Log Analytics Workspace\nis a unique environment for Azure Monitor data, where data is collected, aggregated, and serves as the administrative boundary.\nWithin a workspace, data is collected from various sources and is used for analysis, visualization, and alerting. Configurations\ncan include data export rules, saved queries, and custom functions to enhance data analytics capabilities.",
+          "stability": "stable",
+          "summary": "Represents an Azure Log Analytics Workspace."
         },
         "locationInModule": {
           "filename": "src/azure-loganalytics/lib/workspace.ts",
-          "line": 133
+          "line": 180
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the Log Analytics workspace."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `location`: The Azure region where the workspace will be deployed.\n  - `name`: The name of the workspace, which must be globally unique.\n  - `resourceGroup`: The Azure Resource Group under which the workspace is deployed.\n  - `sku`: Optional. The SKU of the workspace, affecting pricing and features.\n  - `retention`: Optional. The number of days data will be retained in the workspace.\n  - `tags`: Optional. Tags to assign to the workspace for organizational purposes.\n  - `dataExport`: Optional. Configurations for exporting data to other Azure resources.\n  - `functions`: Optional. Custom functions defined within the workspace for query operations.\n  - `queries`: Optional. Saved queries that can be used for data analysis or visualizations.\n\nExample usage:\n```typescript\nnew Workspace(this, 'MyLogAnalyticsWorkspace', {\nlocation: 'East US',\nname: 'myWorkspace',\nresourceGroup: myResourceGroup,\nsku: 'PerGB2018',\nretention: 60,\ntags: { department: 'IT' },\nfunctions: [{\nname: 'ErrorCount',\ndisplayName: 'Error Count',\nquery: 'AzureActivity | summarize count() by bin(timestamp, 1h), type',\nfunctionAlias: 'error_count',\nfunctionParameters: 'timestamp, type'\n}],\nqueries: [{\nname: 'HighCPUUsage',\ncategory: 'Performance',\ndisplayName: 'High CPU Usage',\nquery: 'Perf | where CounterName == \"% Processor Time\" and CounterValue > 80'\n}]\n});\n```\nThis class sets up the workspace and applies configurations, providing a centralized environment for monitoring and analytics.",
+              "summary": "- The properties required to configure the Log Analytics workspace, as defined in the WorkspaceProps interface."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_loganalytics.WorkspaceProps"
@@ -10026,36 +10445,28 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_metricalert.MetricAlert",
       "initializer": {
         "docs": {
+          "remarks": "This class encapsulates the configuration and management of a Metric Alert, allowing users to define alert rules based on the metrics from their Azure resources. Metric Alerts can help in proactively managing the health, performance, and availability of Azure services.\n\nProperties:\n- `name`: The name of the Metric Alert, which must be unique within the resource group.\n- `description`: Optional. A description of what the Metric Alert monitors and potential impact or remediation.\n- `enabled`: Indicates whether the alert rule is enabled. Disabled rules will not fire.\n- `autoMitigate`: Specifies whether the alert should attempt auto-mitigation actions when triggered.\n- `frequency`: The frequency of evaluation for the alert rule, determining how often the rule is checked.\n- `severity`: The severity level assigned to the alert. This helps in categorizing the urgency of the alert.\n- `targetResourceType`: Specifies the type of Azure resource the alert rule applies to, necessary for scoping the alert.\n- `targetResourceLocation`: Specifies the location of the target resource, required when the alert rule covers resources in multiple locations.\n- `windowSize`: The period over which data is collected for analysis, which must be greater than the frequency of evaluation.\n- `tags`: User-defined tags to help organize and identify resources within Azure.\n- `criteria`: The conditions that trigger the alert. This can be static or dynamic, based on the behavior of the monitored metric over time.\n- `dynamicCriteria`: Advanced configurations for criteria that dynamically adjust thresholds based on historical data.\n- `scopes`: The specific resources that the Metric Alert is scoped to monitor.\n- `resourceGroup`: The Azure Resource Group in which this Metric Alert is defined.\n\nExample usage:\n```typescript\nconst cpuAlertProps: IMetricAlertProps = {\n  name: 'High CPU Usage Alert',\n  resourceGroup: resourceGroupInstance,\n  scopes: [vm.id],\n  criteria: [\n    {\n      metricName: 'Percentage CPU',\n      operator: 'GreaterThan',\n      threshold: 80,\n      aggregation: 'Average'\n    }\n  ],\n  frequency: 'PT1M',\n  windowSize: 'PT5M',\n  severity: 3,\n  enabled: true\n};\n\nconst cpuAlert = new MetricAlert(this, 'cpuUsageAlert', cpuAlertProps);\n```\n\nThis configuration defines a Metric Alert that monitors CPU usage across specified virtual machines, triggering an alert if the CPU usage exceeds 80% over a 5-minute window, evaluated every minute.",
           "stability": "stable",
-          "summary": "Constructs a new instance of the MetricAlert class."
+          "summary": "Represents a Metric Alert in Azure Monitor, which is used to automatically monitor metrics across Azure services and trigger actions when certain conditions are met."
         },
         "locationInModule": {
           "filename": "src/azure-metricalert/lib/metric-alert.ts",
-          "line": 18
+          "line": 57
         },
         "parameters": [
           {
-            "docs": {
-              "summary": "- The scope in which this construct is defined."
-            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
-            "docs": {
-              "summary": "- The ID of this construct."
-            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
-            "docs": {
-              "summary": "- The properties required for Metric Alert."
-            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_metricalert.IMetricAlertProps"
@@ -11598,26 +12009,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_networksecuritygroup.SecurityGroup",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of an Azure Network Security Group, which acts as a virtual firewall\nfor virtual network resources. A Network Security Group contains a list of security rules that allow or deny network traffic\nto resources connected to Azure Virtual Networks (VNet). Each rule specifies a combination of source and destination, port,\nand protocol, and an action (allow or deny) based on those combinations. This class allows for detailed configuration of these\nrules to enforce security policies for inbound and outbound network traffic.",
+          "stability": "stable",
+          "summary": "Represents an Azure Network Security Group (NSG)."
         },
         "locationInModule": {
           "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-          "line": 92
+          "line": 130
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the security group."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `resourceGroup`: The Azure Resource Group under which the NSG will be deployed.\n  - `location`: The Azure region where the NSG will be created.\n  - `name`: The name of the NSG, which must be unique within the resource group.\n  - `rules`: A list of rules that define the security policies for traffic control.\n\nExample usage:\n```typescript\nnew SecurityGroup(this, 'MySecurityGroup', {\nresourceGroup: myResourceGroup,\nlocation: 'East US',\nname: 'myNsg',\nrules: [{\nname: 'AllowSSH',\npriority: 100,\ndirection: 'Inbound',\naccess: 'Allow',\nprotocol: 'Tcp',\nsourcePortRange: '*',\ndestinationPortRange: '22',\nsourceAddressPrefix: '*',\ndestinationAddressPrefix: '*'\n}]\n});\n```\nThis class initializes a Network Security Group with specified rules, handling network security management tasks efficiently.",
+              "summary": "- The properties required to configure the Network Security Group, as defined in the SecurityGroupProps interface."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_networksecuritygroup.SecurityGroupProps"
@@ -11633,15 +12056,21 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method attaches the security group to a network interface, applying the security group's rules to the network interface.\nThis allows for fine-grained control of network traffic to and from the specific network interface.",
+            "stability": "stable",
+            "summary": "Associates this Network Security Group with a specified network interface."
           },
           "locationInModule": {
             "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-            "line": 135
+            "line": 203
           },
           "name": "associateToNetworkInterface",
           "parameters": [
             {
+              "docs": {
+                "remarks": "Example usage:\n```typescript\nconst myNetworkInterface = { id: 'nic-456', name: 'NetworkInterfaceA' };\nmySecurityGroup.associateToNetworkInterface(myNetworkInterface);\n```\nThis operation ensures that the security rules defined in the network security group are applied directly to the specified\nnetwork interface, controlling access in a more targeted manner.",
+                "summary": "- The network interface object to which this network security group will be associated."
+              },
               "name": "networkInterface",
               "type": {
                 "fqn": "@cdktf/provider-azurerm.networkInterface.NetworkInterface"
@@ -11651,15 +12080,21 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method facilitates the attachment of the security group to a subnet, applying the security group's rules to all\nresources within the subnet. This is crucial for managing network access and security policies at the subnet level.",
+            "stability": "stable",
+            "summary": "Associates this Network Security Group with a specified subnet."
           },
           "locationInModule": {
             "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-            "line": 127
+            "line": 180
           },
           "name": "associateToSubnet",
           "parameters": [
             {
+              "docs": {
+                "remarks": "Example usage:\n```typescript\nconst mySubnet = { id: 'subnet-123', name: 'SubnetA' };\nmySecurityGroup.associateToSubnet(mySubnet);\n```\nThis operation ensures that the security rules defined in the network security group are enforced on all network interfaces\nattached to the specified subnet.",
+                "summary": "- The subnet object to which this network security group will be associated."
+              },
               "name": "subnet",
               "type": {
                 "fqn": "@cdktf/provider-azurerm.subnet.Subnet"
@@ -11739,26 +12174,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_networksecuritygroup.SecurityGroupAssociations",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class provides the functionality to associate a network security group with either subnets or network interfaces\nwithin the Azure environment. By managing these associations, it helps enforce security rules at both the subnet level\nand the network interface level, enhancing security configurations and compliance.",
+          "stability": "stable",
+          "summary": "Manages the associations of Azure Network Security Groups with subnets and network interfaces."
         },
         "locationInModule": {
           "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-          "line": 166
+          "line": 256
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for the association instance."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "Includes the network security group ID and optionally a subnet ID or network interface ID.\n\nExample usage:\n```typescript\nnew SecurityGroupAssociations(this, 'MyAssociations', {\nnetworkSecurityGroupId: 'nsg-123',\nsubnetId: 'subnet-123',\nnetworkInterfaceId: 'nic-456',\n});\n```\nDepending on the properties provided, this class will create the appropriate associations to apply the network security group\nto the specified subnet or network interface.",
+              "summary": "- The properties for the association."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_networksecuritygroup.SecurityGroupAssociationsProps"
@@ -11769,7 +12216,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-        "line": 165
+        "line": 233
       },
       "name": "SecurityGroupAssociations",
       "namespace": "azure_networksecuritygroup",
@@ -11786,7 +12233,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-        "line": 146
+        "line": 214
       },
       "name": "SecurityGroupAssociationsProps",
       "namespace": "azure_networksecuritygroup",
@@ -11800,7 +12247,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-            "line": 150
+            "line": 218
           },
           "name": "networkSecurityGroupId",
           "type": {
@@ -11817,7 +12264,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-            "line": 162
+            "line": 230
           },
           "name": "networkInterfaceId",
           "optional": true,
@@ -11835,7 +12282,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-networksecuritygroup/lib/securitygroup.ts",
-            "line": 156
+            "line": 224
           },
           "name": "subnetId",
           "optional": true,
@@ -12467,17 +12914,18 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_queryrulealert.QueryRuleAlert",
       "initializer": {
         "docs": {
+          "remarks": "This class is responsible for the creation and management of a Scheduled Query Rule Alert in Azure Monitor.\nScheduled Query Rule Alerts execute specified queries at regular intervals over the data collected in Log Analytics\nWorkspaces or Application Insights, and alert based on the results of these queries. These alerts can be used to monitor\napplication health, infrastructure changes, or compliance with certain conditions.",
           "stability": "stable",
-          "summary": "Constructs a new instance of the AzureQueryRuleAlert class."
+          "summary": "Represents an Azure Monitor Scheduled Query Rule Alert."
         },
         "locationInModule": {
           "filename": "src/azure-queryrulealert/lib/query-rule-alert.ts",
-          "line": 152
+          "line": 183
         },
         "parameters": [
           {
             "docs": {
-              "summary": "- The scope in which this construct is defined."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
             },
             "name": "scope",
             "type": {
@@ -12486,7 +12934,7 @@
           },
           {
             "docs": {
-              "summary": "- The ID of this construct."
+              "summary": "- The unique identifier for this instance of the Scheduled Query Rule Alert."
             },
             "name": "id",
             "type": {
@@ -12495,7 +12943,8 @@
           },
           {
             "docs": {
-              "summary": "- The properties required for Azure Query Rule Alert."
+              "remarks": "These include:\n  - `name`: The name of the Scheduled Query Rule.\n  - `resourceGroup`: The Azure Resource Group under which the alert will be created.\n  - `location`: The Azure region where the alert will be deployed.\n  - `criteriaQuery`: The query to execute. The results of this query determine whether an alert should be triggered.\n  - `evaluationFrequency`: How often the query should be run.\n  - `windowDuration`: The time period over which data is collected for each execution of the query.\n  - `severity`: The severity of the alert.\n  - `actionActionGroupId`: The action group to invoke when the alert criteria are met.\n  - `enabled`: Indicates whether the alert rule is enabled.\n\nExample usage:\n```typescript\nnew QueryRuleAlert(this, 'MyAlertRule', {\nname: 'HighErrorRateAlert',\nresourceGroup: myResourceGroup,\nlocation: 'West US 2',\ncriteriaQuery: 'Heartbeat | summarize AggregatedValue = count() by bin(TimeGenerated, 5m)',\nevaluationFrequency: 'PT5M',\nwindowDuration: 'PT1H',\nseverity: 3,\nactionActionGroupId: ['/subscriptions/sub-id/resourceGroups/rg/providers/microsoft.insights/actionGroups/myActionGroup'],\nenabled: true\n});\n```\nThis class sets up the alert rule and ensures it is ready to trigger actions based on the specified criteria and schedule.",
+              "summary": "- The properties required to configure the Scheduled Query Rule Alert, as defined in the AzureQueryRuleAlertProps interface."
             },
             "name": "props",
             "type": {
@@ -12564,26 +13013,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_resourcegroup.Group",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of an Azure Resource Group, which is a container that holds\nrelated resources for an Azure solution. A resource group includes those resources that you want to manage as a group.\nYou decide how to allocate resources to resource groups based on what makes the most sense for your organization.",
+          "stability": "stable",
+          "summary": "Represents an Azure Resource Group."
         },
         "locationInModule": {
           "filename": "src/azure-resourcegroup/lib/resource-group.ts",
-          "line": 41
+          "line": 69
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the Resource Group."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These can include:\n  - `location`: The Azure region where the Resource Group will be created.\n  - `name`: The name of the Resource Group, which must be unique within your Azure subscription.\n  - `tags`: A dictionary of tags to apply to the Resource Group for organizational, billing, or other purposes.\n  - `ignoreChanges`: A list of properties which should be ignored if changes are made after initial deployment,\n    useful in certain scenarios where properties are externally managed or should not trigger updates.\n\nExample usage:\n```typescript\nnew Group(this, 'MyResourceGroup', {\nlocation: 'East US',\nname: 'ApplicationResources',\ntags: {\nenvironment: 'production'\n}\n});\n```\nThis class sets up the resource group and applies any specified configurations, making it ready to hold other Azure resources.",
+              "summary": "- Optional properties for configuring the Resource Group."
+            },
             "name": "props",
             "optional": true,
             "type": {
@@ -12813,24 +13274,23 @@
       "assembly": "@microsoft/terraform-cdk-constructs",
       "base": "@microsoft/terraform-cdk-constructs.core_azure.AzureResourceWithAlert",
       "docs": {
-        "remarks": "This class provides methods to easily manage storage resources such as Containers,\nFile Shares, Tables, Queues, and Network Rules.\n\nExample usage:\n```typescript\nconst storageAccount = new AzureStorageAccount(this, 'storageaccount', {\n  name: 'myStorageAccount',\n  location: 'East US',\n  resourceGroup: myResourceGroup,\n  accountReplicationType: 'LRS',\n  accountTier: 'Standard',\n  // other properties\n});\n```",
-        "stability": "stable",
-        "summary": "Represents an Azure Storage Account within a Terraform deployment."
+        "stability": "stable"
       },
       "fqn": "@microsoft/terraform-cdk-constructs.azure_storageaccount.Account",
       "initializer": {
         "docs": {
+          "remarks": "This class is responsible for the creation and management of an Azure Storage Account, which is a scalable and secure service\nfor storing large amounts of unstructured data that can be accessed from anywhere in the world over HTTP or HTTPS. Common uses\nof the Azure Storage Account include storing of blobs (objects), file shares, tables, and queues. This class provides methods\nto manage storage resources, configure network rules, and integrate with Azure Active Directory for secure access management.",
           "stability": "stable",
-          "summary": "Initializes a new AzureStorageAccount."
+          "summary": "Represents an Azure Storage Account within a Terraform deployment."
         },
         "locationInModule": {
           "filename": "src/azure-storageaccount/lib/account.ts",
-          "line": 154
+          "line": 166
         },
         "parameters": [
           {
             "docs": {
-              "summary": "The scope in which to define this construct."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
             },
             "name": "scope",
             "type": {
@@ -12839,7 +13299,7 @@
           },
           {
             "docs": {
-              "summary": "The scoped construct ID."
+              "summary": "- The unique identifier for this instance of the storage account."
             },
             "name": "id",
             "type": {
@@ -12848,7 +13308,8 @@
           },
           {
             "docs": {
-              "summary": "Configuration properties for the Azure Storage Account."
+              "remarks": "These include:\n  - `name`: The name of the storage account, which must be unique within the Azure region.\n  - `location`: The Azure region where the storage account will be created.\n  - `resourceGroup`: The Azure Resource Group under which the storage account will be deployed.\n  - `accountReplicationType`: The type of data replication to ensure data durability and availability.\n  - `accountTier`: The performance tier that affects the type of hardware used for the storage account.\n  - `tags`: A dictionary of tags to apply to the storage account for organizational purposes.\n\nExample usage:\n```typescript\nconst storageAccount = new Account(this, 'MyStorageAccount', {\nlocation: 'East US',\nname: 'myStorageAccount',\nresourceGroup: myResourceGroup,\naccountReplicationType: 'LRS',\naccountTier: 'Standard',\nenableHttpsTrafficOnly: true,\ntags: {\nenvironment: 'production'\n}\n});\n```\nThis class sets up the storage account with the specified configurations, handles resource allocation, and applies security\nsettings based on the properties provided.",
+              "summary": "- The properties required to configure the Azure Storage Account, as defined in the AccountProps interface."
             },
             "name": "props",
             "type": {
@@ -12860,26 +13321,27 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/azure-storageaccount/lib/account.ts",
-        "line": 136
+        "line": 119
       },
       "methods": [
         {
           "docs": {
             "custom": {
-              "throws": "Error if a container with the same name already exists.\n\nExample usage:\n```typescript\nconst container = storageAccount.addContainer('myContainer', 'private');\n```"
+              "throws": "Error if a container with the same name already exists within the storage account.\n\nThis method creates a new container within the Azure storage account, allowing for the specification of access\nlevel and metadata. If the container already exists, it throws an error to prevent duplication.\n\nExample usage:\n```typescript\nconst container = storageAccount.addContainer('myContainer', 'private', { owner: 'IT' });\n```"
             },
-            "returns": "The created AzureStorageContainer.",
+            "returns": "The created Container instance.",
             "stability": "stable",
             "summary": "Adds a new container to the storage account."
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 205
+            "line": 221
           },
           "name": "addContainer",
           "parameters": [
             {
               "docs": {
+                "remarks": "It must be unique within the storage account.",
                 "summary": "The name of the container."
               },
               "name": "name",
@@ -12889,7 +13351,8 @@
             },
             {
               "docs": {
-                "summary": "The access type of the container (e.g., 'blob', 'private')."
+                "remarks": "Defaults to 'private'.",
+                "summary": "The level of public access to the container."
               },
               "name": "containerAccessType",
               "optional": true,
@@ -12899,7 +13362,7 @@
             },
             {
               "docs": {
-                "summary": "Metadata for the container."
+                "summary": "Optional metadata for the container as key-value pairs."
               },
               "name": "metadata",
               "optional": true,
@@ -12922,20 +13385,21 @@
         {
           "docs": {
             "custom": {
-              "throws": "Error if a share with the same name already exists.\n\nExample usage:\n```typescript\nconst fileShare = storageAccount.addShare('myFileShare', { quota: 1024, accessTier: 'Hot' });\n```"
+              "throws": "Error if a file share with the same name already exists.\n\nThis method facilitates the addition of a file share to the storage account, with optional settings for\ncapacity (quota) and data access frequency (access tier). If a file share with the same name exists, an error is thrown.\n\nExample usage:\n```typescript\nconst fileShare = storageAccount.addFileShare('myFileShare', { quota: 1024, accessTier: 'Hot' });\n```"
             },
-            "returns": "The created AzureStorageShare.",
+            "returns": "The created FileShare instance.",
             "stability": "stable",
             "summary": "Adds a new file share to the storage account."
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 237
+            "line": 257
           },
           "name": "addFileShare",
           "parameters": [
             {
               "docs": {
+                "remarks": "Must be unique within the storage account.",
                 "summary": "The name of the file share."
               },
               "name": "name",
@@ -12945,7 +13409,7 @@
             },
             {
               "docs": {
-                "summary": "Optional properties for the file share (e.g., quota, access tier)."
+                "summary": "Optional properties for configuring the file share, such as quota and access tier."
               },
               "name": "props",
               "optional": true,
@@ -12962,19 +13426,19 @@
         },
         {
           "docs": {
-            "returns": "The configured StorageAccountNetworkRulesA.\n\nExample usage:\n```typescript\nstorageAccount.addNetworkRules({\nbypass: ['AzureServices'],\ndefaultAction: 'Deny',\nipRules: ['1.2.3.4/32'],\nvirtualNetworkSubnetIds: ['subnetId'],\n});\n```",
+            "returns": "The configured network rules.\n\nThis method configures network rules for the storage account, specifying which IPs and virtual networks can access\nthe storage resources. It allows detailed control over data security and access management.\n\nExample usage:\n```typescript\nstorageAccount.addNetworkRules({\nbypass: ['AzureServices'],\ndefaultAction: 'Deny',\nipRules: ['1.2.3.4/32'],\nvirtualNetworkSubnetIds: ['subnetId'],\n});\n```",
             "stability": "stable",
-            "summary": "Adds network rules to the storage account."
+            "summary": "Adds network rules to the storage account to control access based on IP and virtual network settings."
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 321
+            "line": 353
           },
           "name": "addNetworkRules",
           "parameters": [
             {
               "docs": {
-                "summary": "Configuration properties for the network rules."
+                "summary": "Configuration properties for the network rules, including allowed IPs and virtual network subnet IDs."
               },
               "name": "props",
               "type": {
@@ -12990,18 +13454,19 @@
         },
         {
           "docs": {
-            "returns": "The created AzureStorageQueue.\n\nExample usage:\n```typescript\nconst queue = storageAccount.addQueue('myQueue');\n```",
+            "returns": "The created Queue instance.\n\nThis method creates a new queue in the storage account, with optional metadata. It is useful for message queuing\nin applications, enabling asynchronous task processing and inter-service communication.\n\nExample usage:\n```typescript\nconst queue = storageAccount.addQueue('myQueue', { priority: 'high' });\n```",
             "stability": "stable",
             "summary": "Adds a new queue to the storage account."
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 298
+            "line": 326
           },
           "name": "addQueue",
           "parameters": [
             {
               "docs": {
+                "remarks": "Must be unique within the storage account.",
                 "summary": "The name of the queue."
               },
               "name": "name",
@@ -13011,7 +13476,7 @@
             },
             {
               "docs": {
-                "summary": "Optional metadata for the queue."
+                "summary": "Optional metadata for the queue as key-value pairs."
               },
               "name": "metadata",
               "optional": true,
@@ -13034,20 +13499,21 @@
         {
           "docs": {
             "custom": {
-              "throws": "Error if a table with the same name already exists.\n\nExample usage:\n```typescript\nconst table = storageAccount.addTable('myTable');\n```"
+              "throws": "Error if a table with the same name already exists.\n\nThis method creates a new table within the storage account, optionally allowing for access control configurations.\nIt throws an error if a table with the same name already exists, ensuring uniqueness within the account.\n\nExample usage:\n```typescript\nconst table = storageAccount.addTable('myTable', [{ id: 'policy1', type: 'read' }]);\n```"
             },
-            "returns": "The created AzureStorageTable.",
+            "returns": "The created Table instance.",
             "stability": "stable",
             "summary": "Adds a new table to the storage account."
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 272
+            "line": 296
           },
           "name": "addTable",
           "parameters": [
             {
               "docs": {
+                "remarks": "Must be unique within the storage account.",
                 "summary": "The name of the table."
               },
               "name": "name",
@@ -13057,7 +13523,7 @@
             },
             {
               "docs": {
-                "summary": "Optional access control list for the table."
+                "summary": "Optional access control list for the table, specifying permissions."
               },
               "name": "acl",
               "optional": true,
@@ -13088,7 +13554,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 142
+            "line": 125
           },
           "name": "accountKind",
           "type": {
@@ -13102,7 +13568,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 143
+            "line": 126
           },
           "name": "accountTier",
           "type": {
@@ -13116,7 +13582,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 140
+            "line": 123
           },
           "name": "location",
           "type": {
@@ -13130,7 +13596,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 139
+            "line": 122
           },
           "name": "name",
           "type": {
@@ -13144,7 +13610,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 137
+            "line": 120
           },
           "name": "props",
           "type": {
@@ -13157,7 +13623,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 138
+            "line": 121
           },
           "name": "id",
           "overrides": "@microsoft/terraform-cdk-constructs.core_azure.AzureResource",
@@ -13171,7 +13637,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/account.ts",
-            "line": 141
+            "line": 124
           },
           "name": "resourceGroup",
           "overrides": "@microsoft/terraform-cdk-constructs.core_azure.AzureResource",
@@ -13440,26 +13906,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_storageaccount.Blob",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of a blob in an Azure Storage Container. Blobs are unstructured\ndata objects, which can include files like images, documents, videos, or any other file type. The Blob class provides a way\nto manage these files in the cloud, allowing for scalable, durable, and accessible data storage. This class supports various\nblob types such as block blobs for text and binary data, append blobs for log files, and page blobs for large volumes of\nrandom access data.",
+          "stability": "stable",
+          "summary": "Represents a blob within an Azure Storage Container."
         },
         "locationInModule": {
           "filename": "src/azure-storageaccount/lib/container.ts",
-          "line": 78
+          "line": 160
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the blob."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties may include:\n  - `name`: The name of the blob, which must be unique within the container.\n  - `storageAccountName`: The name of the storage account in which the blob is stored.\n  - `storageContainerName`: The name of the storage container in which the blob resides.\n  - `type`: The type of the blob (e.g., 'Block', 'Append', 'Page').\n  - `source`: The source of the blob's content, which could be a path to a file or a URL.\n  - `contentType`: The MIME type of the blob's content, such as 'application/octet-stream' for binary data.\n  - `metadata`: A dictionary of strings that represents metadata to associate with the blob.\n  - `accessTier`: The data access tier, affecting storage costs and data retrieval speeds.\n  - `cacheControl`, `contentEncoding`, `contentDisposition`, `contentMd5`: Optional parameters for controlling the caching behavior,\n    encoding, content disposition, and integrity check of the blob.\n\nExample usage:\n```typescript\nconst myBlob = new Blob(this, 'MyBlob', {\nname: 'exampleblob',\nstorageAccountName: 'mystorageaccount',\nstorageContainerName: 'mycontainer',\ntype: 'Block',\nsource: './path/to/file.jpg',\ncontentType: 'image/jpeg',\nmetadata: {\nauthor: 'John Doe'\n}\n});\n```\nThis class initializes a blob with the specified configurations and handles the uploading of content from the specified source.",
+              "summary": "- Configuration properties for the Azure Storage Blob."
+            },
             "name": "props",
             "type": {
               "fqn": "@cdktf/provider-azurerm.storageBlob.StorageBlobConfig"
@@ -13470,7 +13948,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/azure-storageaccount/lib/container.ts",
-        "line": 75
+        "line": 118
       },
       "name": "Blob",
       "namespace": "azure_storageaccount",
@@ -13482,7 +13960,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/container.ts",
-            "line": 76
+            "line": 119
           },
           "name": "name",
           "type": {
@@ -13501,26 +13979,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_storageaccount.Container",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is designed for the creation and management of an Azure Storage Container, which serves as a unit of storage\nthat houses data objects, known as blobs. Containers are analogous to directories in a file system, and are used to organize\nsets of blobs within a storage account. This class allows for granular control over blob storage, providing functionalities\nsuch as setting access levels, managing metadata, and implementing security measures like encryption scopes.",
+          "stability": "stable",
+          "summary": "Represents an Azure Storage Container within a specific Azure Storage Account."
         },
         "locationInModule": {
           "filename": "src/azure-storageaccount/lib/container.ts",
-          "line": 17
+          "line": 55
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically a reference to the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the container."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `name`: The name of the storage container, which must be unique within the associated storage account.\n  - `storageAccountName`: The name of the storage account where this container is located.\n  - `containerAccessType`: Defines the level of public access to the container. Options include 'container',\n    'blob', or 'none', controlling how the blobs within the container can be accessed.\n  - `defaultEncryptionScope`: Specifies the default encryption scope for the container, enhancing data security.\n  - `encryptionScopeOverrideEnabled`: Allows or prevents overriding the encryption scope on a per-blob basis.\n  - `metadata`: Key-value pairs that provide additional information about the container, which can be used for\n    organizational, search, or billing purposes.\n  - `timeouts`: Specifies custom timeout settings for CRUD operations on the container, providing control over\n    operation durations and retries.\n\nExample usage:\n```typescript\nconst storageContainer = new Container(this, 'MyContainer', {\nname: 'mycontainer',\nstorageAccountName: 'mystorageaccount',\ncontainerAccessType: 'blob',\ndefaultEncryptionScope: 'myEncryptionScope',\nencryptionScopeOverrideEnabled: true,\nmetadata: {\ndepartment: 'Finance'\n}\n});\n```\nThis instantiation sets up a storage container with specified properties including access types and metadata. It is ready\nto house blobs and provides methods to manage these blobs effectively.",
+              "summary": "- Configuration properties for the Azure Storage Container, based on the StorageContainerConfig interface."
+            },
             "name": "props",
             "type": {
               "fqn": "@cdktf/provider-azurerm.storageContainer.StorageContainerConfig"
@@ -13536,19 +14026,20 @@
       "methods": [
         {
           "docs": {
-            "returns": "The created AzureStorageBlob instance.\n\nThis method enables the addition of a blob to an Azure Storage Container. It allows specifying\nthe source of the blob's content, as well as other properties like the blob's type (default is 'Block'),\ncontent type, and metadata. The `filePath` parameter should point to the location of the file to be\nuploaded as a blob.\n\nExample usage:\n```typescript\nconst storageBlob = storageContainer.addBlob('exampleBlob', './path/to/local/file.txt', {\ntype: 'Block',\ncontentType: 'text/plain',\nmetadata: { customKey: 'customValue' }\n});\n```\n\nIn this example, a blob named 'exampleBlob' is added to the storage container. The content of the blob\nis sourced from a local file. The blob is of type 'Block' with a content type of 'text/plain' and custom metadata.",
+            "remarks": "This method facilitates the addition of a blob to an Azure Storage Container managed by this class. It handles the creation and\nconfiguration of the blob, including setting its type, source content, and metadata. This is useful for uploading various types\nof unstructured data, such as images, videos, documents, or other binary files, into a cloud-based storage solution.",
+            "returns": "The newly created Blob object, which represents the blob added to the storage container.\n\nExample usage:\n```typescript\nconst storageBlob = storageContainer.addBlob('exampleBlob', './path/to/local/file.txt', {\ntype: 'Block',\ncontentType: 'text/plain',\nmetadata: { customKey: 'customValue' }\n});\n```\nIn this example, a new blob named 'exampleBlob' is added to the storage container. The content of the blob is sourced\nfrom a local file specified by `filePath`. The blob is configured as a 'Block' type with 'text/plain' content type and\ncustom metadata. The method returns the blob instance for further use or reference.",
             "stability": "stable",
-            "summary": "Adds a blob to an Azure Storage Container."
+            "summary": "Adds a blob to this Azure Storage Container."
           },
           "locationInModule": {
             "filename": "src/azure-storageaccount/lib/container.ts",
-            "line": 60
+            "line": 103
           },
           "name": "addBlob",
           "parameters": [
             {
               "docs": {
-                "summary": "The name of the blob to be added."
+                "summary": "- The name of the blob to be added, which will be used as the blob's unique identifier within the container."
               },
               "name": "blobName",
               "type": {
@@ -13557,7 +14048,8 @@
             },
             {
               "docs": {
-                "summary": "The file path or URL for the source of the blob's content."
+                "remarks": "This specifies the location of the file to be uploaded.",
+                "summary": "- The file path or URL for the source of the blob's content."
               },
               "name": "filePath",
               "type": {
@@ -13566,7 +14058,7 @@
             },
             {
               "docs": {
-                "summary": "Optional configuration properties for the blob, such as blob type, content type, and metadata."
+                "summary": "- Optional configuration properties for the blob, which include:   - `type`: The type of the blob (e.g., 'Block', 'Append', 'Page'). Default is 'Block'.   - `contentType`: The MIME type of the blob's content, such as 'application/octet-stream' for binary data. This helps browsers     and other clients handle the file correctly when it's downloaded or accessed.   - `metadata`: A dictionary of key-value pairs to store as metadata with the blob. Metadata is typically used to store additional     details about the blob, such as tags, descriptions, or other attributes."
               },
               "name": "props",
               "optional": true,
@@ -13611,26 +14103,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_storageaccount.File",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of a file in an Azure Storage Share, which allows for cloud file storage\nthat can be accessed and managed like a file system. The File class enables detailed configuration of file properties including\ncontent type, encoding, and metadata, making it suitable for storing and accessing various types of data.",
+          "stability": "stable",
+          "summary": "Represents a file within an Azure Storage Share."
         },
         "locationInModule": {
           "filename": "src/azure-storageaccount/lib/fileshare.ts",
-          "line": 118
+          "line": 154
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the file."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n  - `name`: The name of the file within the storage share.\n  - `storageShareId`: The identifier for the storage share in which this file is located.\n  - `source`: The source of the file's content, which can be a path to a local file or a URL.\n  - `contentType`: The MIME type of the file's content, helping clients handle the file appropriately when downloaded.\n  - `contentEncoding`: The encoding format of the file's content (e.g., 'gzip').\n  - `contentDisposition`: Provides instructions on how the content should be displayed or handled.\n  - `contentMd5`: An MD5 hash of the file content for verifying the integrity of the file upon transfer.\n  - `metadata`: A dictionary of key-value pairs to store as metadata with the file. Metadata is typically used to store additional\n    details about the file such as tags, descriptions, or other attributes.\n\nExample usage:\n```typescript\nconst myFile = new File(this, 'MyFile', {\nname: 'examplefile.txt',\nstorageShareId: 'share123',\nsource: './path/to/local/file.txt',\ncontentType: 'text/plain',\ncontentEncoding: 'utf-8',\nmetadata: {\ncreatedBy: 'John Doe'\n}\n});\n```\nThis class initializes a file with the specified configurations and handles the uploading of content from the specified source, providing\na way to manage file storage in Azure efficiently.",
+              "summary": "- Configuration properties for the Azure Storage Share File."
+            },
             "name": "props",
             "type": {
               "fqn": "@cdktf/provider-azurerm.storageShareFile.StorageShareFileConfig"
@@ -14077,26 +14581,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_storageaccount.Queue",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of an Azure Storage Queue, which is a service for storing large numbers\nof messages that can be accessed from anywhere in the world via authenticated calls using HTTP or HTTPS. A single queue message\ncan be up to 64 KB in size, and a queue can contain millions of messages, up to the total capacity limit of a storage account.\nThis class provides a way to manage messages in a scalable and secure manner.",
+          "stability": "stable",
+          "summary": "Represents an Azure Storage Queue within a specific Azure Storage Account."
         },
         "locationInModule": {
           "filename": "src/azure-storageaccount/lib/queue.ts",
-          "line": 10
+          "line": 39
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the queue."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties may include:\n  - `name`: The name of the queue, which must be unique within the storage account.\n  - `storageAccountName`: The name of the storage account in which this queue is being created.\n  - `metadata`: A dictionary of strings that represents metadata to associate with the queue.\n  - `timeouts`: Custom timeout settings for CRUD operations on the queue to manage operation durations and retries.\n\nExample usage:\n```typescript\nconst myQueue = new Queue(this, 'MyQueue', {\nname: 'taskqueue',\nstorageAccountName: 'mystorageaccount',\nmetadata: {\ndepartment: 'IT'\n}\n});\n```\nThis class initializes a storage queue with the specified configurations. It can be used to enqueue and process messages as needed\nwithin applications, providing a reliable messaging solution for asynchronous communication and coordination of tasks across systems.",
+              "summary": "- Configuration properties for the Azure Storage Queue."
+            },
             "name": "props",
             "type": {
               "fqn": "@cdktf/provider-azurerm.storageQueue.StorageQueueConfig"
@@ -14138,26 +14654,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_storageaccount.Table",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of an Azure Storage Table, which provides a NoSQL key-attribute data store\nthat can massively scale. It is suitable for storing structured, non-relational data, allowing rapid development and fast access to large\nquantities of data. The class facilitates creating and configuring storage tables including setting up access control lists (ACLs).",
+          "stability": "stable",
+          "summary": "Represents an Azure Storage Table within a specific Azure Storage Account."
         },
         "locationInModule": {
           "filename": "src/azure-storageaccount/lib/table.ts",
-          "line": 10
+          "line": 41
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the table."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n  - `name`: The name of the table, which must be unique within the storage account.\n  - `storageAccountName`: The name of the storage account in which this table is being created.\n  - `acl`: An optional list of access control entries that define permissions for accessing the table.\n  - `timeouts`: Optional timeout settings for create/read/update/delete operations on the table.\n\nExample usage:\n```typescript\nconst storageTable = new Table(this, 'MyTable', {\nname: 'tasktable',\nstorageAccountName: 'mystorageaccount',\nacl: [{\nid: 'myacl',\npermissions: 'rwdl',\nstart: '2020-01-01T01:00:00Z',\nexpiry: '2030-01-01T01:00:00Z',\npolicy: 'mypolicy'\n}]\n});\n```\nThis class initializes a storage table with the specified configurations and provides an interface to manage access controls and\nother properties. It is ideal for applications that require structured, scalable, and fast access to data.",
+              "summary": "- Configuration properties for the Azure Storage Table."
+            },
             "name": "props",
             "type": {
               "fqn": "@cdktf/provider-azurerm.storageTable.StorageTableConfig"
@@ -14305,17 +14833,18 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualmachine.LinuxVM",
       "initializer": {
         "docs": {
+          "remarks": "This class is designed to provision and manage a Linux VM in Azure, facilitating detailed configuration including\nVM size, the operating system image, network settings, and administrative credentials. It supports custom data scripts,\nSSH configurations, and optional features like managed identity and boot diagnostics.",
           "stability": "stable",
-          "summary": "Constructs a new instance of the AzureLinuxVirtualMachine class."
+          "summary": "Represents a Linux-based Virtual Machine (VM) within Microsoft Azure."
         },
         "locationInModule": {
           "filename": "src/azure-virtualmachine/lib/vm.ts",
-          "line": 350
+          "line": 426
         },
         "parameters": [
           {
             "docs": {
-              "summary": "- The scope in which this construct is defined."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) application."
             },
             "name": "scope",
             "type": {
@@ -14324,7 +14853,7 @@
           },
           {
             "docs": {
-              "summary": "- The ID of this construct."
+              "summary": "- The unique identifier for this instance of the Linux VM, used within the scope for reference."
             },
             "name": "id",
             "type": {
@@ -14333,7 +14862,8 @@
           },
           {
             "docs": {
-              "summary": "- The properties for defining a Linux Virtual Machine."
+              "remarks": "These include:\n  - `location`: The geographic location where the VM will be hosted (e.g., \"eastus\").\n  - `name`: The name of the VM, which must be unique within the resource group.\n  - `resourceGroup`: The ResourceGroup within which the VM will be created.\n  - `size`: The size specification of the VM (e.g., \"Standard_B2s\").\n  - `availabilitySetId`: The ID of the availability set in which to include the VM.\n  - `userData`: Custom data scripts to pass to the VM upon creation.\n  - `adminSshKey`: SSH keys for secure access to the VM.\n  - `zone`: The availability zone for deploying the VM.\n  - `identity`: Managed identity settings for accessing other Azure services.\n  - `additionalCapabilities`: Special capabilities like Ultra Disk support.\n  - `sourceImageReference`: A reference to the specific Linux image to be used for the VM.\n  - `sourceImageId`: The identifier for a custom image to use for the VM.\n  - `tags`: Key-value pairs for resource tagging.\n  - `osDisk`: Configuration for the VM's operating system disk.\n  - `subnet`: Specifies the subnet within which the VM will be placed.\n  - `publicIPAllocationMethod`: Method used to allocate a public IP address.\n  - `customData`: Additional scripts or commands passed to the VM at startup.\n  - `enableSshAzureADLogin`: Option to enable Azure AD login for SSH.\n  - `bootDiagnosticsStorageURI`: URI for storage where VM boot diagnostics are collected.\n\nExample usage:\n```typescript\nconst linuxVM = new LinuxVM(this, 'MyLinuxVM', {\nresourceGroup: myResourceGroup,\nname: 'myVM',\nsize: 'Standard_DS1_v2',\nadminUsername: 'adminuser',\nadminSshKey: [{ publicKey: 'ssh-rsa AAAAB...' }],\nsourceImageReference: { publisher: 'Canonical', offer: 'UbuntuServer', sku: '18.04-LTS', version: 'latest' },\nosDisk: { caching: 'ReadWrite', storageAccountType: 'Standard_LRS' },\nsubnet: mySubnet,\ntags: { environment: 'production' }\n});\n```\nThis class initializes a Linux VM with the specified configurations, handling details like network setup, OS installation,\nand security settings, thus providing a robust infrastructure for hosting applications on Linux environments.",
+              "summary": "- Configuration properties for the Linux Virtual Machine, derived from the LinuxVMProps interface."
             },
             "name": "props",
             "type": {
@@ -14345,7 +14875,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/azure-virtualmachine/lib/vm.ts",
-        "line": 335
+        "line": 371
       },
       "name": "LinuxVM",
       "namespace": "azure_virtualmachine",
@@ -14357,7 +14887,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 340
+            "line": 376
           },
           "name": "name",
           "type": {
@@ -14371,7 +14901,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 337
+            "line": 373
           },
           "name": "props",
           "type": {
@@ -14385,7 +14915,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 341
+            "line": 377
           },
           "name": "publicIp",
           "optional": true,
@@ -14399,7 +14929,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 339
+            "line": 375
           },
           "name": "id",
           "overrides": "@microsoft/terraform-cdk-constructs.core_azure.AzureResource",
@@ -14413,7 +14943,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 338
+            "line": 374
           },
           "name": "resourceGroup",
           "overrides": "@microsoft/terraform-cdk-constructs.core_azure.AzureResource",
@@ -14434,7 +14964,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/azure-virtualmachine/lib/vm.ts",
-        "line": 217
+        "line": 253
       },
       "name": "LinuxVMProps",
       "namespace": "azure_virtualmachine",
@@ -14448,7 +14978,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 233
+            "line": 269
           },
           "name": "resourceGroup",
           "type": {
@@ -14464,7 +14994,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 269
+            "line": 305
           },
           "name": "additionalCapabilities",
           "optional": true,
@@ -14481,7 +15011,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 284
+            "line": 320
           },
           "name": "adminPassword",
           "optional": true,
@@ -14498,7 +15028,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 254
+            "line": 290
           },
           "name": "adminSshKey",
           "optional": true,
@@ -14529,7 +15059,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 279
+            "line": 315
           },
           "name": "adminUsername",
           "optional": true,
@@ -14546,7 +15076,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 244
+            "line": 280
           },
           "name": "availabilitySetId",
           "optional": true,
@@ -14563,7 +15093,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 332
+            "line": 368
           },
           "name": "bootDiagnosticsStorageURI",
           "optional": true,
@@ -14580,7 +15110,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 322
+            "line": 358
           },
           "name": "customData",
           "optional": true,
@@ -14597,7 +15127,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 327
+            "line": 363
           },
           "name": "enableSshAzureADLogin",
           "optional": true,
@@ -14614,7 +15144,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 264
+            "line": 300
           },
           "name": "identity",
           "optional": true,
@@ -14632,7 +15162,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 222
+            "line": 258
           },
           "name": "location",
           "optional": true,
@@ -14650,7 +15180,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 228
+            "line": 264
           },
           "name": "name",
           "optional": true,
@@ -14668,7 +15198,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 306
+            "line": 342
           },
           "name": "osDisk",
           "optional": true,
@@ -14685,7 +15215,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 317
+            "line": 353
           },
           "name": "publicIPAllocationMethod",
           "optional": true,
@@ -14702,7 +15232,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 274
+            "line": 310
           },
           "name": "secret",
           "optional": true,
@@ -14725,7 +15255,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 239
+            "line": 275
           },
           "name": "size",
           "optional": true,
@@ -14742,7 +15272,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 295
+            "line": 331
           },
           "name": "sourceImageId",
           "optional": true,
@@ -14760,7 +15290,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 290
+            "line": 326
           },
           "name": "sourceImageReference",
           "optional": true,
@@ -14778,7 +15308,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 312
+            "line": 348
           },
           "name": "subnet",
           "optional": true,
@@ -14795,7 +15325,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 300
+            "line": 336
           },
           "name": "tags",
           "optional": true,
@@ -14817,7 +15347,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 249
+            "line": 285
           },
           "name": "userData",
           "optional": true,
@@ -14834,7 +15364,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachine/lib/vm.ts",
-            "line": 259
+            "line": 295
           },
           "name": "zone",
           "optional": true,
@@ -15016,17 +15546,18 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualmachine.WindowsVM",
       "initializer": {
         "docs": {
+          "remarks": "This class is designed to provision and manage a Windows VM in Azure, allowing for detailed configuration including\nthe VM's size, the operating system image, network settings, and administrative credentials. It supports customization\nof the OS disk, networking setup, and optional features like custom data scripts and boot diagnostics.",
           "stability": "stable",
-          "summary": "Constructs a new instance of the AzureWindowsVirtualMachine class."
+          "summary": "Represents a Windows-based Virtual Machine (VM) within Microsoft Azure."
         },
         "locationInModule": {
           "filename": "src/azure-virtualmachine/lib/vm.ts",
-          "line": 124
+          "line": 160
         },
         "parameters": [
           {
             "docs": {
-              "summary": "- The scope in which this construct is defined."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) application."
             },
             "name": "scope",
             "type": {
@@ -15035,7 +15566,7 @@
           },
           {
             "docs": {
-              "summary": "- The ID of this construct."
+              "summary": "- The unique identifier for this instance of the Windows VM, used within the scope for reference."
             },
             "name": "id",
             "type": {
@@ -15044,7 +15575,8 @@
           },
           {
             "docs": {
-              "summary": "- The properties for defining a Windows Virtual Machine."
+              "remarks": "These include:\n  - `location`: The geographic location where the VM will be hosted (e.g., \"eastus\").\n  - `name`: The name of the VM, which must be unique within the resource group.\n  - `resourceGroup`: The ResourceGroup within which the VM will be created.\n  - `size`: The size specification of the VM (e.g., \"Standard_B2s\").\n  - `adminUsername`: The administrator username for accessing the VM.\n  - `adminPassword`: The administrator password for accessing the VM.\n  - `sourceImageReference`: A reference to the specific Windows image to be used for the VM.\n  - `sourceImageId`: The identifier for a custom image to use for the VM.\n  - `tags`: Key-value pairs for resource tagging.\n  - `osDisk`: Configuration for the VM's operating system disk.\n  - `subnet`: Specifies the subnet within which the VM will be placed.\n  - `publicIPAllocationMethod`: The method used to allocate a public IP address to the VM.\n  - `customData`: Scripts or commands passed to the VM at startup.\n  - `bootstrapCustomData`: Custom data used to trigger the Azure Custom Script Extension for VM setup tasks.\n  - `bootDiagnosticsStorageURI`: URI for storage where VM boot diagnostics are collected.\n\nExample usage:\n```typescript\nconst vm = new WindowsVM(this, 'MyWindowsVM', {\nresourceGroup: myResourceGroup,\nname: 'myVM',\nsize: 'Standard_DS1_v2',\nadminUsername: 'adminuser',\nadminPassword: 'securepassword123',\nsourceImageReference: { publisher: 'MicrosoftWindowsServer', offer: 'WindowsServer', sku: '2019-Datacenter', version: 'latest' },\nosDisk: { caching: 'ReadWrite', storageAccountType: 'Standard_LRS' },\nsubnet: mySubnet,\ntags: { environment: 'production' }\n});\n```\nThis class initializes a Windows VM with the specified configurations, handling details like network setup, OS installation,\nand security settings, thus providing a robust infrastructure for hosting applications on Windows Server environments.",
+              "summary": "- Configuration properties for the Windows Virtual Machine, derived from the WindowsVMProps interface."
             },
             "name": "props",
             "type": {
@@ -15426,17 +15958,18 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualmachinescaleset.LinuxCluster",
       "initializer": {
         "docs": {
+          "remarks": "This class is designed to provision and manage a scale set of Linux virtual machines, providing capabilities such as\nauto-scaling, high availability, and simplified management. It supports detailed configurations like VM size, operating\nsystem image, network settings, and administrative credentials. Additional functionalities include custom data scripts,\nSSH configurations, and optional features like managed identity and boot diagnostics.",
           "stability": "stable",
-          "summary": "Constructs a new instance of the AzureLinuxVirtualMachine class."
+          "summary": "Represents a Linux Virtual Machine Scale Set (VMSS) within Microsoft Azure."
         },
         "locationInModule": {
           "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-          "line": 171
+          "line": 216
         },
         "parameters": [
           {
             "docs": {
-              "summary": "- The scope in which this construct is defined."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) application."
             },
             "name": "scope",
             "type": {
@@ -15445,7 +15978,7 @@
           },
           {
             "docs": {
-              "summary": "- The ID of this construct."
+              "summary": "- The unique identifier for this instance of the Linux cluster, used within the scope for reference."
             },
             "name": "id",
             "type": {
@@ -15454,7 +15987,8 @@
           },
           {
             "docs": {
-              "summary": "- The properties for defining a Linux Virtual Machine."
+              "remarks": "These include:\n  - `location`: The geographic location where the scale set will be hosted (e.g., \"eastus\").\n  - `name`: The name of the scale set, which must be unique within the resource group.\n  - `resourceGroup`: The ResourceGroup within which the scale set will be created.\n  - `sku`: The size specification of the VMs (e.g., \"Standard_B2s\").\n  - `adminUsername`: The administrator username for the VMs.\n  - `adminPassword`: The administrator password for the VMs.\n  - `adminSshKey`: SSH keys for secure access to the VMs.\n  - `zones`: The availability zones for deploying the VMs.\n  - `identity`: Managed identity settings for accessing other Azure services.\n  - `sourceImageReference`: A reference to the specific Linux image to be used for the VMs.\n  - `sourceImageId`: The identifier for a custom image to use for the VMs.\n  - `tags`: Key-value pairs for resource tagging.\n  - `osDisk`: Configuration for the VMs' operating system disks.\n  - `subnet`: Specifies the subnet within which the VMs will be placed.\n  - `publicIPAddress`: Method used to allocate public IP addresses to the VMs.\n  - `customData`: Scripts or commands passed to the VMs at startup.\n  - `instances`: The number of VM instances in the scale set.\n  - `upgradePolicyMode`: The upgrade policy mode for the VMSS.\n  - `overprovision`: Specifies if the VMSS should be overprovisioned to maintain capacity during updates.\n  - `scaleInPolicy`: The scale-in policy for the VMSS.\n  - `bootDiagnosticsStorageURI`: URI for storage where VMSS boot diagnostics are collected.\n  - `enableSshAzureADLogin`: Option to enable Azure AD login for SSH on the VMs.\n\nExample usage:\n```typescript\nconst linuxCluster = new LinuxCluster(this, 'MyLinuxCluster', {\nresourceGroup: myResourceGroup,\nname: 'myCluster',\nsku: 'Standard_DS1_v2',\nadminUsername: 'adminuser',\nadminSshKey: [{ publicKey: 'ssh-rsa AAAAB...' }],\nsourceImageReference: { publisher: 'Canonical', offer: 'UbuntuServer', sku: '18.04-LTS', version: 'latest' },\nosDisk: { caching: 'ReadWrite', storageAccountType: 'Standard_LRS' },\nsubnet: mySubnet,\ninstances: 3,\ntags: { environment: 'production' }\n});\n```\nThis class initializes a Linux VM Scale Set with the specified configurations, handling details like VM creation,\nscaling policies, network setup, OS installation, and security settings, providing a robust and scalable infrastructure\nfor hosting cloud-based Linux applications.",
+              "summary": "- Configuration properties for the Linux VM Scale Set, derived from the LinuxClusterProps interface."
             },
             "name": "props",
             "type": {
@@ -15998,17 +16532,18 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualmachinescaleset.WindowsCluster",
       "initializer": {
         "docs": {
+          "remarks": "This class provides a way to deploy and manage a scale set of Windows virtual machines, allowing for configurations such as\nauto-scaling, high availability, and simplified patch management. It supports detailed specifications including\nVM size, the operating system image, network settings, and administrative credentials. Additional capabilities include\ncustom data scripts, automatic OS updates, and optional features like managed identity and boot diagnostics.",
           "stability": "stable",
-          "summary": "Constructs a new instance of the AzureWindowsVirtualMachine class."
+          "summary": "Represents a Windows Virtual Machine Scale Set (VMSS) within Microsoft Azure."
         },
         "locationInModule": {
           "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-          "line": 376
+          "line": 465
         },
         "parameters": [
           {
             "docs": {
-              "summary": "- The scope in which this construct is defined."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) application."
             },
             "name": "scope",
             "type": {
@@ -16017,7 +16552,7 @@
           },
           {
             "docs": {
-              "summary": "- The ID of this construct."
+              "summary": "- The unique identifier for this instance of the Windows cluster, used within the scope for reference."
             },
             "name": "id",
             "type": {
@@ -16026,7 +16561,8 @@
           },
           {
             "docs": {
-              "summary": "- The properties for defining a Windows Virtual Machine."
+              "remarks": "These include:\n  - `location`: The geographic location where the scale set will be hosted (e.g., \"eastus\").\n  - `name`: The name of the scale set, which must be unique within the resource group.\n  - `resourceGroup`: The ResourceGroup within which the scale set will be created.\n  - `sku`: The size specification of the VMs (e.g., \"Standard_B2s\").\n  - `adminUsername`: The administrator username for the VMs.\n  - `adminPassword`: The administrator password for the VMs.\n  - `zones`: The availability zones for deploying the VMs.\n  - `instances`: The number of VM instances in the scale set.\n  - `sourceImageReference`: A reference to the specific Windows image to be used for the VMs.\n  - `sourceImageId`: The identifier for a custom image to use for the VMs.\n  - `tags`: Key-value pairs for resource tagging.\n  - `osDisk`: Configuration for the VMs' operating system disks.\n  - `subnet`: Specifies the subnet within which the VMs will be placed.\n  - `publicIPAddress`: Method used to allocate public IP addresses to the VMs.\n  - `customData`: Scripts or commands passed to the VMs at startup.\n  - `upgradePolicyMode`: The upgrade policy mode for the VMSS.\n  - `overprovision`: Specifies if the VMSS should be overprovisioned to maintain capacity during updates.\n  - `scaleInPolicy`: The scale-in policy for the VMSS.\n  - `bootDiagnosticsStorageURI`: URI for storage where VMSS boot diagnostics are collected.\n  - `enableSshAzureADLogin`: Option to enable Azure AD login for SSH on the VMs.\n\nExample usage:\n```typescript\nconst windowsCluster = new WindowsCluster(this, 'MyWindowsCluster', {\nresourceGroup: myResourceGroup,\nname: 'myCluster',\nsku: 'Standard_DS1_v2',\nadminUsername: 'adminuser',\nadminPassword: 'securepassword123',\nsourceImageReference: { publisher: 'MicrosoftWindowsServer', offer: 'WindowsServer', sku: '2019-Datacenter', version: 'latest' },\nosDisk: { caching: 'ReadWrite', storageAccountType: 'Standard_LRS' },\nsubnet: mySubnet,\ninstances: 3,\ntags: { environment: 'production' }\n});\n```\nThis class initializes a Windows VM Scale Set with the specified configurations, handling details like VM creation,\nscaling policies, network setup, OS installation, and security settings, providing a robust and scalable infrastructure\nfor hosting cloud-based Windows applications.",
+              "summary": "- Configuration properties for the Windows VM Scale Set, derived from the WindowsClusterProps interface."
             },
             "name": "props",
             "type": {
@@ -16038,7 +16574,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-        "line": 363
+        "line": 408
       },
       "name": "WindowsCluster",
       "namespace": "azure_virtualmachinescaleset",
@@ -16050,7 +16586,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 367
+            "line": 412
           },
           "name": "name",
           "type": {
@@ -16064,7 +16600,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 364
+            "line": 409
           },
           "name": "props",
           "type": {
@@ -16077,7 +16613,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 366
+            "line": 411
           },
           "name": "id",
           "overrides": "@microsoft/terraform-cdk-constructs.core_azure.AzureResource",
@@ -16091,7 +16627,7 @@
           },
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 365
+            "line": 410
           },
           "name": "resourceGroup",
           "overrides": "@microsoft/terraform-cdk-constructs.core_azure.AzureResource",
@@ -16112,7 +16648,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-        "line": 253
+        "line": 298
       },
       "name": "WindowsClusterProps",
       "namespace": "azure_virtualmachinescaleset",
@@ -16126,7 +16662,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 285
+            "line": 330
           },
           "name": "adminPassword",
           "type": {
@@ -16142,7 +16678,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 280
+            "line": 325
           },
           "name": "adminUsername",
           "type": {
@@ -16158,7 +16694,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 269
+            "line": 314
           },
           "name": "resourceGroup",
           "type": {
@@ -16175,7 +16711,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 344
+            "line": 389
           },
           "name": "boostrapCustomData",
           "optional": true,
@@ -16192,7 +16728,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 349
+            "line": 394
           },
           "name": "bootDiagnosticsStorageURI",
           "optional": true,
@@ -16209,7 +16745,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 339
+            "line": 384
           },
           "name": "customData",
           "optional": true,
@@ -16227,7 +16763,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 296
+            "line": 341
           },
           "name": "instances",
           "optional": true,
@@ -16245,7 +16781,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 258
+            "line": 303
           },
           "name": "location",
           "optional": true,
@@ -16263,7 +16799,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 264
+            "line": 309
           },
           "name": "name",
           "optional": true,
@@ -16281,7 +16817,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 318
+            "line": 363
           },
           "name": "osDisk",
           "optional": true,
@@ -16299,7 +16835,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 355
+            "line": 400
           },
           "name": "overprovision",
           "optional": true,
@@ -16316,7 +16852,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 329
+            "line": 374
           },
           "name": "publicIPAddress",
           "optional": true,
@@ -16338,7 +16874,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 360
+            "line": 405
           },
           "name": "scaleInPolicy",
           "optional": true,
@@ -16356,7 +16892,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 275
+            "line": 320
           },
           "name": "sku",
           "optional": true,
@@ -16373,7 +16909,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 307
+            "line": 352
           },
           "name": "sourceImageId",
           "optional": true,
@@ -16391,7 +16927,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 302
+            "line": 347
           },
           "name": "sourceImageReference",
           "optional": true,
@@ -16409,7 +16945,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 324
+            "line": 369
           },
           "name": "subnet",
           "optional": true,
@@ -16426,7 +16962,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 312
+            "line": 357
           },
           "name": "tags",
           "optional": true,
@@ -16448,7 +16984,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 334
+            "line": 379
           },
           "name": "upgradePolicyMode",
           "optional": true,
@@ -16465,7 +17001,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/azure-virtualmachinescaleset/lib/cluster.ts",
-            "line": 290
+            "line": 335
           },
           "name": "zones",
           "optional": true,
@@ -16490,26 +17026,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualnetwork.Network",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for the creation and management of a virtual network, which provides an isolated environment\nwhere Azure resources, such as VMs and databases, can securely communicate with each other, the internet, and on-premises\nnetworks. It supports configurations such as multiple address spaces and subnets, enabling complex networking scenarios.",
+          "stability": "stable",
+          "summary": "Represents an Azure Virtual Network (VNet) within Microsoft Azure."
         },
         "locationInModule": {
           "filename": "src/azure-virtualnetwork/lib/network.ts",
-          "line": 66
+          "line": 94
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) application."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the network, used within the scope for reference."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `resourceGroup`: The ResourceGroup within which the virtual network will be created.\n  - `name`: Optional. The name of the virtual network. If not provided, a default name will be assigned.\n  - `location`: Optional. The Azure region where the virtual network will be deployed. Defaults to the resource group's region.\n  - `addressSpace`: Optional. A list of CIDR blocks that define the address spaces of the virtual network.\n  - `subnets`: Optional. An array of subnets to be created within the virtual network, each defined by a name and a CIDR block.\n\nExample usage:\n```typescript\nconst network = new Network(this, 'MyVirtualNetwork', {\nresourceGroup: myResourceGroup,\nname: 'myVNet',\nlocation: 'West US',\naddressSpace: ['10.0.0.0/16'],\nsubnets: [{ name: 'subnet1', addressPrefixes: ['10.0.1.0/24'] }]\n});\n```\nThis class initializes a virtual network with the specified configurations and handles the provisioning of subnets\nwithin the network, providing a foundational networking layer for hosting cloud resources.",
+              "summary": "- Configuration properties for the Azure Virtual Network, derived from the NetworkProps interface."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualnetwork.NetworkProps"
@@ -16525,21 +17073,30 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method configures a two-way peering connection, allowing resources in both virtual networks to communicate\nseamlessly. It sets up peering settings such as network access, traffic forwarding, and gateway transit based on\nprovided configurations.",
+            "stability": "stable",
+            "summary": "Establishes a peering connection between this virtual network and another remote virtual network."
           },
           "locationInModule": {
             "filename": "src/azure-virtualnetwork/lib/network.ts",
-            "line": 108
+            "line": 167
           },
           "name": "addVnetPeering",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The remote virtual network with which to establish a peering connection."
+              },
               "name": "remoteVirtualNetwork",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualnetwork.Network"
               }
             },
             {
+              "docs": {
+                "remarks": "Controls aspects like virtual network access, traffic forwarding, and use of gateways.",
+                "summary": "- Optional settings applied from this virtual network to the remote virtual network."
+              },
               "name": "localPeerSettings",
               "optional": true,
               "type": {
@@ -16547,6 +17104,10 @@
               }
             },
             {
+              "docs": {
+                "remarks": "Allows customization of how the remote network interacts with this one.\n\nExample usage:\n```typescript\n// Assuming 'this' is a reference to a local virtual network instance.\nconst partnerVNet = new Network(this, 'PartnerVNet', { ... });\nthis.addVnetPeering(partnerVNet, {\nallowVirtualNetworkAccess: true,\nallowForwardedTraffic: false,\nallowGatewayTransit: true,\nuseRemoteGateways: false\n}, {\nallowVirtualNetworkAccess: true,\nallowForwardedTraffic: true,\nallowGatewayTransit: false,\nuseRemoteGateways: false\n});\n```\nThis method invokes the `Peer` class to create a peering between 'this' virtual network and 'partnerVNet'.\nThe settings control traffic behavior and access permissions in both directions of the peering.",
+                "summary": "- Optional settings applied from the remote virtual network to this virtual network."
+              },
               "name": "remotePeerSettings",
               "optional": true,
               "type": {
@@ -16776,26 +17337,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualnetwork.Peer",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class facilitates the peering between two virtual networks, allowing resources in either network to communicate\nwith each other as if they were within the same network. It supports advanced configurations such as traffic forwarding,\ngateway transit, and access settings. This peering does not require a VPN gateway and offers low-latency, high-bandwidth\nconnections between resources in different virtual networks.",
+          "stability": "stable",
+          "summary": "Represents a Virtual Network Peering within Microsoft Azure."
         },
         "locationInModule": {
           "filename": "src/azure-virtualnetwork/lib/peering.ts",
-          "line": 60
+          "line": 99
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) application."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique name for this instance of the network peering."
+            },
             "name": "name",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These include:\n  - `virtualNetwork`: The local virtual network object.\n  - `remoteVirtualNetwork`: The remote virtual network object.\n  - `localToRemoteSettings`: Configuration settings applied from the local virtual network to the remote virtual network.\n  - `remoteToLocalSettings`: Configuration settings applied from the remote virtual network to the local virtual network.\n\nExample usage:\n```typescript\nconst vnetPeering = new Peer(this, 'VNetPeering', {\nvirtualNetwork: myVNet,\nremoteVirtualNetwork: partnerVNet,\nlocalToRemoteSettings: {\nallowVirtualNetworkAccess: true,\nallowForwardedTraffic: false,\nallowGatewayTransit: false,\nuseRemoteGateways: false\n},\nremoteToLocalSettings: {\nallowVirtualNetworkAccess: true,\nallowForwardedTraffic: true,\nallowGatewayTransit: false,\nuseRemoteGateways: false\n}\n});\n```\nThis class initializes a VNet peering with the specified configurations, enabling direct connectivity between\nthe specified virtual networks. It manages the creation and configuration of network peering settings, ensuring\nthat both VNets are appropriately linked and configured according to the defined properties.",
+              "summary": "- Configuration properties for the network peering, derived from the PeerProps interface."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.azure_virtualnetwork.PeerProps"
@@ -17085,21 +17658,30 @@
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method creates a new role assignment which grants the specified Azure AD object access to resources\nat the scope defined by this construct. This is useful for programmatically managing access controls,\nensuring only authorized users or systems can perform specific actions on Azure resources.",
+            "stability": "stable",
+            "summary": "Adds an access role assignment for a specified Azure AD object (e.g., user, group, service principal) within this RBAC construct's scope."
           },
           "locationInModule": {
             "filename": "src/core-azure/lib/resource.ts",
-            "line": 20
+            "line": 36
           },
           "name": "addAccess",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The unique identifier of the Azure AD object (user, group, or service principal) that will receive the role assignment."
+              },
               "name": "objectId",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "remarks": "This role defines the permissions that the object will have.\n\nExample usage:\n```typescript\n// Example: Assign a \"Reader\" role to a user for the current RBAC scope\nrbacInstance.addAccess('user-object-id', 'Reader');\n```",
+                "summary": "- The human-readable name of the Azure RBAC role to be assigned."
+              },
               "name": "customRoleName",
               "type": {
                 "primitive": "string"
@@ -17109,15 +17691,22 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This method creates and configures a new DiagnosticSettings instance which captures and routes\ndiagnostic data (logs and metrics) to the specified destinations such as Azure Monitor,\nan Event Hubs instance, a Log Analytics workspace, or an Azure Storage account.",
+            "returns": "An instance of the DiagnosticSettings class, configured with the provided properties.\n\nExample usage:\n```typescript\nconst diagSettings = resource.addDiagSettings({\nname: 'custom-diag-settings',\nlogAnalyticsWorkspaceId: 'workspace-id',\neventhubAuthorizationRuleId: 'auth-rule-id',\neventhubName: 'eventhub-name',\nstorageAccountId: 'storage-account-id'\n});\n```",
+            "stability": "stable",
+            "summary": "Adds diagnostic settings to a specified resource within this construct."
           },
           "locationInModule": {
             "filename": "src/core-azure/lib/resource.ts",
-            "line": 29
+            "line": 73
           },
           "name": "addDiagSettings",
           "parameters": [
             {
+              "docs": {
+                "remarks": "These include:\n  - `name`: Optional. The name of the diagnostic settings resource. Defaults to 'diag-settings'.\n  - `logAnalyticsWorkspaceId`: Optional. The identifier of the Log Analytics workspace to send logs.\n  - `eventhubAuthorizationRuleId`: Optional. The authorization rule ID for an Event Hub where logs will be forwarded.\n  - `eventhubName`: Optional. The name of the Event Hub to which logs will be sent.\n  - `storageAccountId`: Optional. The identifier of the Azure Storage account where logs will be stored.\n  - `logAnalyticsDestinationType`: Optional. Determines if logs are sent to dedicated or legacy tables in Log Analytics. Defaults to undefined which uses the default settings.\n  The `targetResourceId` is automatically set to the ID of this construct instance.",
+                "summary": "- The properties required to configure the diagnostic settings."
+              },
               "name": "props",
               "type": {
                 "fqn": "@microsoft/terraform-cdk-constructs.core_azure.BaseDiagnosticSettingsProps"
@@ -17136,7 +17725,7 @@
           },
           "locationInModule": {
             "filename": "src/core-azure/lib/resource.ts",
-            "line": 43
+            "line": 87
           },
           "name": "setupResourceGroup",
           "parameters": [
@@ -17222,7 +17811,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/core-azure/lib/resource.ts",
-        "line": 60
+        "line": 104
       },
       "methods": [
         {
@@ -17231,7 +17820,7 @@
           },
           "locationInModule": {
             "filename": "src/core-azure/lib/resource.ts",
-            "line": 68
+            "line": 112
           },
           "name": "addMetricAlert",
           "parameters": [
@@ -17249,7 +17838,7 @@
           },
           "locationInModule": {
             "filename": "src/core-azure/lib/resource.ts",
-            "line": 61
+            "line": 105
           },
           "name": "addQueryRuleAlert",
           "parameters": [
@@ -17458,26 +18047,38 @@
       "fqn": "@microsoft/terraform-cdk-constructs.core_azure.DiagnosticSettings",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "remarks": "This class is responsible for configuring Azure Monitor Diagnostic Settings to collect and route metrics and logs from\nAzure resources to monitoring and analytics services. Diagnostic settings can be applied to resources like VMs,\nApp Services, and more, allowing collected data to be sent to Event Hubs, Log Analytics workspaces, or Azure Storage.",
+          "stability": "stable",
+          "summary": "Manages the diagnostic settings for monitoring Azure resources."
         },
         "locationInModule": {
           "filename": "src/core-azure/lib/diagsettings.ts",
-          "line": 60
+          "line": 96
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The unique identifier for this instance of the diagnostic settings."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "remarks": "These properties include:\n  - `name`: Optional. The name of the diagnostic settings. If not provided, a unique name will be generated.\n  - `targetResourceId`: The ID of the Azure resource to which these diagnostic settings apply.\n  - `storageAccountId`: Optional. The ID of the Azure Storage account to which logs and metrics are sent.\n  - `eventhubAuthorizationRuleId`: Optional. The authorization rule ID for the Event Hub namespace.\n  - `eventhubName`: Optional. The name of the Event Hub where metrics and logs will be sent.\n  - `logAnalyticsWorkspaceId`: Optional. The ID of the Log Analytics workspace to which logs and metrics are sent.\n  - `partnerSolutionId`: Optional. ID of a partner solution that configurations are fetched from.\n  - `logCategories`: Optional. Categories of logs to collect.\n  - `metricCategories`: Optional. Categories of metrics to collect.\n  - `logAnalyticsDestinationType`: Optional. Specifies whether logs should be stored in a dedicated table or the\n    legacy AzureDiagnostics table in the Log Analytics workspace.\n\nExample usage:\n```typescript\nconst resourceGroup = new ResourceGroup(this, 'ResourceGroup', { ... });\nconst diagnostics = new DiagnosticSettings(this, 'MyDiagnostics', {\nname: 'example-diagnostics',\ntargetResourceId: resourceGroup.id,\nlogAnalyticsWorkspaceId: logAnalyticsWorkspace.id,\nstorageAccountId: storageAccount.id,\nlogCategories: ['Write', 'Delete'],\nmetricCategories: ['AllMetrics']\n});\n```\nThis class configures the diagnostic settings to collect specific logs and metrics from the target resource and routes them\nto specified destinations such as Log Analytics, Storage Account, or Event Hubs.",
+              "summary": "- Configuration properties for diagnostic settings."
+            },
             "name": "props",
             "type": {
               "fqn": "@microsoft/terraform-cdk-constructs.core_azure.DiagnosticSettingsProps"
@@ -17556,17 +18157,18 @@
       "fqn": "@microsoft/terraform-cdk-constructs.core_azure.Rbac",
       "initializer": {
         "docs": {
+          "remarks": "This class is responsible for creating and managing RBAC role assignments in Azure, which control permissions for Azure AD\nidentities to manage Azure resources. It supports assigning roles at different scopes such as subscriptions, resource groups,\nor specific resources.",
           "stability": "stable",
-          "summary": "Constructs a new instance of the AzureRbac class."
+          "summary": "Manages Role-Based Access Control (RBAC) assignments within Azure."
         },
         "locationInModule": {
           "filename": "src/core-azure/lib/rbac.ts",
-          "line": 37
+          "line": 55
         },
         "parameters": [
           {
             "docs": {
-              "summary": "- The scope in which this construct is defined."
+              "summary": "- The scope in which to define this construct, typically representing the Cloud Development Kit (CDK) stack."
             },
             "name": "scope",
             "type": {
@@ -17575,7 +18177,7 @@
           },
           {
             "docs": {
-              "summary": "- The ID of this construct."
+              "summary": "- The unique identifier for this instance of the RBAC assignment."
             },
             "name": "id",
             "type": {
@@ -17584,7 +18186,8 @@
           },
           {
             "docs": {
-              "summary": "- The properties required for Azure RBAC."
+              "remarks": "These properties include:\n  - `objectId`: The Azure AD object ID for the user, group, or service principal to which the role is assigned.\n  - `roleDefinitionUUID`: Optional. The UUID of the Azure RBAC role definition. This can be obtained via Azure CLI.\n  - `roleDefinitionName`: The name of the role to be assigned, such as 'Contributor', 'Reader', or 'Owner'.\n  - `scope`: The scope at which the role is assigned, which could be a subscription, resource group, or specific resource.\n\nExample usage:\n```typescript\nconst rbac = new Rbac(this, 'rbacAssignment', {\nobjectId: 'user-or-group-object-id',\nroleDefinitionName: 'Contributor',\nscope: '/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}'\n});\n```\nThis RBAC instance assigns the 'Contributor' role to a user or group specified by 'objectId' at the scope of a specific resource group.",
+              "summary": "- Configuration properties for the RBAC assignment."
             },
             "name": "props",
             "type": {
@@ -17688,6 +18291,6 @@
       "symbolId": "src/core-azure/lib/rbac:RbacProps"
     }
   },
-  "version": "0.0.3-pre.6",
-  "fingerprint": "Lm2ujbTpHGvu161GOF5DX7e7ZwczP9ynpQoPqGvRGJ8="
+  "version": "0.0.3-pre.7",
+  "fingerprint": "PShCliXIIPYsGbSPKZOFWQWTYMWMRqjZf4tXsrfJZYk="
 }