fix docs

Author: wasaga

docs/resources/route.md

@@ -41,7 +41,13 @@ Route for Pomerium.
 - `jwt_issuer_format` (String) Format for JWT issuer strings. Use 'IssuerHostOnly' for hostname without scheme or trailing slash, or 'IssuerURI' for complete URI including scheme and trailing slash.
 - `kubernetes_service_account_token` (String) Kubernetes service account token.
 - `kubernetes_service_account_token_file` (String) Path to the Kubernetes service account token file.
-- `load_balancing_policy` (String) Load balancing policy.
+- `load_balancing_policy` (String) The following values are valid for the Load Balancing Policy field:
+
+- `round_robin`
+- `maglev`
+- `random`
+- `ring_hash`
+- `least_request`
 - `logo_url` (String) URL to the logo image.
 - `pass_identity_headers` (Boolean) If applied, passes X-Pomerium-Jwt-Assertion header and JWT Claims Headers to the upstream application.
 - `path` (String) Matches incoming requests with a path that is an exact match for the specified path.

internal/provider/enum_optional.go

@@ -30,6 +30,21 @@ func GetValidEnumValuesCanonical[T protoreflect.Enum](prefix string) []string {
 	return values
 }
 
+// GetValidEnumValuesCanonicalMarkdown returns a markdown string of valid enum values for a given protobuf enum type
+func GetValidEnumValuesCanonicalMarkdown[T protoreflect.Enum](name, prefix string) string {
+	vals := GetValidEnumValuesCanonical[T](prefix)
+	var sb strings.Builder
+	sb.WriteString("The following values are valid for the ")
+	sb.WriteString(name)
+	sb.WriteString(" field:\n\n")
+	for _, v := range vals {
+		sb.WriteString("- `")
+		sb.WriteString(v)
+		sb.WriteString("`\n")
+	}
+	return sb.String()
+}
+
 // EnumValueToPBWithDefault converts a string to a protobuf enum value.
 func OptionalEnumValueToPB[T interface {
 	~int32

internal/provider/route.go

@@ -211,8 +211,9 @@ func (r *RouteResource) Schema(_ context.Context, _ resource.SchemaRequest, resp
 				},
 			},
 			"load_balancing_policy": schema.StringAttribute{
-				Description: "Load balancing policy.",
-				Optional:    true,
+				Description:         "Load balancing policy.",
+				MarkdownDescription: GetValidEnumValuesCanonicalMarkdown[pb.LoadBalancingPolicy]("Load Balancing Policy", "LOAD_BALANCING_POLICY"),
+				Optional:            true,
 				Validators: []validator.String{
 					stringvalidator.OneOf(GetValidEnumValuesCanonical[pb.LoadBalancingPolicy]("LOAD_BALANCING_POLICY")...),
 				},