fix: enhance variable descriptions

Author: Rahul-4480

examples/complete/variables.tf

@@ -1,29 +1,29 @@
 variable "workgroup_name" {
-  description = "(Required) Name of the workgroup"
+  description = "(Required) The name of the Athena workgroup that will manage and isolate query execution and resource usage"
   type        = string
 }
 
 variable "query_results_bucket" {
-  description = "The S3 bucket where Athena query results will be stored."
+  description = "(Required) The name of the S3 bucket where Athena will store the output of executed queries"
   type        = string
 }
 
 variable "database_name" {
-  description = "The name of the Athena database."
+  description = "(Required) The name of the Athena database in the AWS Glue Catalog that will contain the schema definitions for your ALB logs"
   type        = string
 }
 
 variable "s3_bucket_name" {
-  description = "The name of the S3 bucket where ALB logs are stored."
+  description = "(Required) The name of the S3 bucket that holds the raw Application Load Balancer (ALB) logs"
   type        = string
 }
 
 variable "alb_access_logs_table_name" {
-  description = "The table name for the alb access logs"
+  description = "The name of the Glue Catalog table that will store the parsed ALB access logs"
   type        = string
 }
 
 variable "alb_connection_logs_table_name" {
-  description = "The table name for the alb connection logs"
+  description = "The name of the Glue Catalog table that will store the parsed ALB connection logs"
   type        = string
 }

examples/minimal/variables.tf

@@ -1,19 +1,19 @@
 variable "workgroup_name" {
-  description = "(Required) Name of the workgroup"
+  description = "(Required) The name of the Athena workgroup that will manage and isolate query execution and resource usage"
   type        = string
 }
 
 variable "query_results_bucket" {
-  description = "The S3 bucket where Athena query results will be stored."
+  description = "(Required) The name of the S3 bucket where Athena will store the output of executed queries"
   type        = string
 }
 
 variable "database_name" {
-  description = "The name of the Athena database."
+  description = "(Required) The name of the Athena database in the AWS Glue Catalog that will contain the schema definitions for your ALB logs"
   type        = string
 }
 
 variable "s3_bucket_name" {
-  description = "The name of the S3 bucket where ALB logs are stored."
+  description = "(Required) The name of the S3 bucket that holds the raw Application Load Balancer (ALB) logs"
   type        = string
 }

variables.tf

@@ -1,31 +1,31 @@
 variable "workgroup_name" {
-  description = "(Required) Name of the workgroup"
+  description = "(Required) The name of the Athena workgroup that will manage and isolate query execution and resource usage"
   type        = string
 }
 
 variable "query_results_bucket" {
-  description = "The S3 bucket where Athena query results will be stored."
+  description = "(Required) The name of the S3 bucket where Athena will store the output of executed queries"
   type        = string
 }
 
 variable "database_name" {
-  description = "The name of the Athena database."
+  description = "(Required) The name of the Athena database in the AWS Glue Catalog that will contain the schema definitions for your ALB logs"
   type        = string
 }
 
 variable "s3_bucket_name" {
-  description = "The name of the S3 bucket where ALB logs are stored."
+  description = "(Required) The name of the S3 bucket that holds the raw Application Load Balancer (ALB) logs"
   type        = string
 }
 
 variable "alb_access_logs_table_name" {
-  description = "The table name for the alb access logs"
+  description = "(Optional) The name of the Glue Catalog table that will store the parsed ALB access logs"
   type        = string
   default     = "alb_access_logs"
 }
 
 variable "alb_connection_logs_table_name" {
-  description = "The table name for the alb connection logs"
+  description = "(Optional) The name of the Glue Catalog table that will store the parsed ALB connection logs"
   type        = string
   default     = "alb_connection_logs"
 }