[WIP] Update resource documentation based on review feedback

providers/aws/resources/aws.lr

@@ -273,7 +273,7 @@ private aws.waf.rulegroup @defaults("name") {
 
 // Amazon WAF rule
 private aws.waf.rule @defaults("name") {
-  // arn of the acl/ruleGroup + the name of the rule
+  // ARN of the ACL/rule group combined with the rule name
   id string
   // Name of the rule
   name string
@@ -2421,7 +2421,7 @@ private aws.s3.bucket.corsrule @defaults("name") {
   name string
   // List of allowed headers
   allowedHeaders []string
-  // List of allowed methods GET, POST, PUT, and so on
+  // List of allowed methods: GET, POST, PUT, and so on
   allowedMethods []string
   // List of origins from which the bucket can be accessed
   allowedOrigins []string
@@ -2835,7 +2835,7 @@ aws.rds {
 
 // Amazon RDS Backup Setting
 private aws.rds.backupsetting {
-  // Target fot the backup setting
+  // Target for the backup setting
   target string
   // Retention period for the backup setting
   retentionPeriod int

providers/azure/resources/azure.lr

@@ -276,7 +276,7 @@ azure.subscription.batchService.account.pool @defaults("id name") {
   etag string
   // Pool identity configuration
   identity dict
-  // Pool properties
+  // Pool configuration settings including scale, network, and task scheduling options
   properties dict
   // Pool provisioning state
   provisioningState string
@@ -1110,23 +1110,23 @@ private azure.subscription.storageService.account.fileProperties.protocolSetting
 private azure.subscription.storageService.account.service.properties @defaults("id") {
   // ID of the service
   id string
-  // Hourly metrics properties
+  // Hourly metrics collection settings
   hourMetrics azure.subscription.storageService.account.service.properties.metrics
-  // Minute metrics properties
+  // Minute metrics collection settings
   minuteMetrics azure.subscription.storageService.account.service.properties.metrics
-  // Logging properties
+  // Storage analytics logging configuration (read, write, delete operations)
   logging azure.subscription.storageService.account.service.properties.logging
 }
 
 // Azure Storage account blob service properties
 private azure.subscription.storageService.account.service.blobProperties @defaults("id") {
   // ID of the service
   id string
-  // Hourly metrics properties
+  // Hourly metrics collection settings
   hourMetrics azure.subscription.storageService.account.service.properties.metrics
-  // Minute metrics properties
+  // Minute metrics collection settings
   minuteMetrics azure.subscription.storageService.account.service.properties.metrics
-  // Logging properties
+  // Storage analytics logging configuration (read, write, delete operations)
   logging azure.subscription.storageService.account.service.properties.logging
   // Whether versioning is enabled for blobs
   isVersioningEnabled bool
@@ -1378,25 +1378,25 @@ private azure.subscription.webService.appsiteconfig @defaults("id name") {
 
 // Azure App Service Hosting Environment
 private azure.subscription.webService.hostingEnvironment @defaults("id name") {
-  // environment ID
+  // Environment ID
   id string
-  // environment name
+  // Environment name
   name string
-  // environment type
+  // Environment type
   type string
   // Kind of resource (e.g., "app,linux,container")
   kind string
-  // environment location
+  // Environment location
   location string
-  // environment tags
+  // Environment tags
   tags map[string]string
-  // environment properties
+  // Environment properties
   properties dict
   // Provisioning state of the environment
   provisioningState string
-  // status of the environment
+  // Status of the environment
   status string
-  // true if the environment is suspended
+  // Whether the environment is suspended
   suspended bool
   // DNS suffix of the environment
   dnsSuffix string
@@ -2391,7 +2391,7 @@ private azure.subscription.advisorService.recommendation @defaults("name categor
   category string
   // Recommendation risk
   risk string
-  // Recommendation risk
+  // Recommendation impact
   impact string
   // Recommendation description
   description string

providers/cloudflare/resources/cloudflare.lr

@@ -150,7 +150,7 @@ private cloudflare.streams.liveInput @defaults("uid name") {
 
 // Cloudflare videos and recordings
 private cloudflare.streams.video @defaults("name id") {
-	// cnquery resource id
+	// cnquery resource ID
 	id string
 
 	// Unique identifier

providers/core/resources/core.lr

@@ -147,7 +147,7 @@ cpe @defaults("uri") {
   targetSw() string
   // Target hardware of the CPE
   targetHw() string
-  // Other of the CPE
+  // Additional CPE attributes not covered by other fields
   other() string
 }