docs: improve doc comments

evgeniy-scherbina · evgeniy-scherbina · commit 4bd2f81fe852 · 2025-06-18T14:01:04.000Z
diff --git a/provider/workspace_preset.go b/provider/workspace_preset.go
@@ -212,7 +212,9 @@ See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for a complete
 	}
 }
 
-// validatePrebuildsCronSpec ensures that the minute field is set to *
+// validatePrebuildsCronSpec ensures that the minute field is set to *.
+// This is required because autoscaling schedules represent continuous time ranges,
+// and we want the schedule to cover entire hours rather than specific minute intervals.
 func validatePrebuildsCronSpec(spec string) error {
 	parts := strings.Fields(spec)
 	if len(parts) != 5 {

Original file line number	Diff line number	Diff line change
`@@ -212,7 +212,9 @@ See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for a complete`
`212`	`212`	`}`
`213`	`213`	`}`
`214`	`214`
`215`		`-// validatePrebuildsCronSpec ensures that the minute field is set to *`
	`215`	`+// validatePrebuildsCronSpec ensures that the minute field is set to *.`
	`216`	`+// This is required because autoscaling schedules represent continuous time ranges,`
	`217`	`+// and we want the schedule to cover entire hours rather than specific minute intervals.`
`216`	`218`	`func validatePrebuildsCronSpec(spec string) error {`
`217`	`219`	`parts := strings.Fields(spec)`
`218`	`220`	`if len(parts) != 5 {`