improve docs

Author: evgeniy-scherbina

provider/workspace_preset.go

@@ -136,14 +136,16 @@ func workspacePresetDataSource() *schema.Resource {
 							},
 						},
 						"autoscaling": {
-							Type:     schema.TypeList,
-							Optional: true,
-							MaxItems: 1,
+							Type:        schema.TypeList,
+							Description: "Configuration block that defines autoscaling behavior for prebuilds. Use this to automatically adjust the number of prebuild instances based on a schedule.",
+							Optional:    true,
+							MaxItems:    1,
 							Elem: &schema.Resource{
 								Schema: map[string]*schema.Schema{
 									"timezone": {
-										Type:     schema.TypeString,
-										Required: true,
+										Type:        schema.TypeString,
+										Description: "The timezone to use for the autoscaling schedule (e.g., \"UTC\", \"America/New_York\").",
+										Required:    true,
 										ValidateFunc: func(val interface{}, key string) ([]string, []error) {
 											timezone := val.(string)
 
@@ -156,14 +158,16 @@ func workspacePresetDataSource() *schema.Resource {
 										},
 									},
 									"schedule": {
-										Type:     schema.TypeList,
-										Required: true,
-										MinItems: 1,
+										Type:        schema.TypeList,
+										Description: "One or more schedule blocks that define when to scale the number of prebuild instances.",
+										Required:    true,
+										MinItems:    1,
 										Elem: &schema.Resource{
 											Schema: map[string]*schema.Schema{
 												"cron": {
-													Type:     schema.TypeString,
-													Required: true,
+													Type:        schema.TypeString,
+													Description: "A cron expression that defines when this schedule should be active. The cron expression must be in the format \"* HOUR * * DAY-OF-WEEK\" where HOUR is 0-23 and DAY-OF-WEEK is 0-6 (Sunday-Saturday). The minute, day-of-month, and month fields must be \"*\".",
+													Required:    true,
 													ValidateFunc: func(val interface{}, key string) ([]string, []error) {
 														cronSpec := val.(string)
 
@@ -181,8 +185,9 @@ func workspacePresetDataSource() *schema.Resource {
 													},
 												},
 												"instances": {
-													Type:     schema.TypeInt,
-													Required: true,
+													Type:        schema.TypeInt,
+													Description: "The number of prebuild instances to maintain during this schedule period.",
+													Required:    true,
 												},
 											},
 										},