From 1fe458568fe61d7ed46bb34533529bfb9557c1b7 Mon Sep 17 00:00:00 2001
From: Mike Morris <1149913+mikemorris@users.noreply.github.com>
Date: Thu, 2 May 2024 18:19:23 -0400
Subject: [PATCH] doc: clarify expected behavior for bad reference in
 GatewayClass ParametersRef

---
 apis/v1/gatewayclass_types.go | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/apis/v1/gatewayclass_types.go b/apis/v1/gatewayclass_types.go
index 31bce40255..92d6504f77 100644
--- a/apis/v1/gatewayclass_types.go
+++ b/apis/v1/gatewayclass_types.go
@@ -25,7 +25,6 @@ import (
 // +kubebuilder:object:root=true
 // +kubebuilder:resource:categories=gateway-api,scope=Cluster,shortName=gc
 // +kubebuilder:subresource:status
-// +kubebuilder:storageversion
 // +kubebuilder:printcolumn:name="Controller",type=string,JSONPath=`.spec.controllerName`
 // +kubebuilder:printcolumn:name="Accepted",type=string,JSONPath=`.status.conditions[?(@.type=="Accepted")].status`
 // +kubebuilder:printcolumn:name="Age",type=date,JSONPath=`.metadata.creationTimestamp`
@@ -93,8 +92,10 @@ type GatewayClassSpec struct {
 	// or an implementation-specific custom resource. The resource can be
 	// cluster-scoped or namespace-scoped.
 	//
-	// If the referent cannot be found, the GatewayClass's "InvalidParameters"
-	// status condition will be true.
+	// If the referent cannot be found, refers to an unsupported kind, or when
+	// the data within that resource is malformed, the GatewayClass will be
+	// rejected with the "Accepted" status condition set to "False" and an
+	// "InvalidParameters" reason.
 	//
 	// A Gateway for this GatewayClass may provide its own `parametersRef`. When both are specified,
 	// the merging behavior is implementation specific.