docs: improve GWC GatewayClassReasonInvalidParameters reason description (#3553)

* docs: GatewayClassReasonInvalidParameters reason

Signed-off-by: Mattia Lavacca <[email protected]>

* Update apis/v1/gatewayclass_types.go

Co-authored-by: Rob Scott <[email protected]>

---------

Signed-off-by: Mattia Lavacca <[email protected]>
Co-authored-by: Rob Scott <[email protected]>

Author: mlavacca

apis/v1/gatewayclass_types.go

@@ -180,9 +180,12 @@ const (
 	GatewayClassReasonAccepted GatewayClassConditionReason = "Accepted"
 
 	// This reason is used with the "Accepted" condition when the GatewayClass
-	// was not accepted because the parametersRef field refers to a nonexistent
-	// or unsupported resource or kind, or when the data within that resource is
-	// malformed.
+	// was not accepted because the parametersRef field refers to
+	// * a namespaced resource but the Namespace field is not set, or
+	// * a cluster-scoped resource but the Namespace field is set, or
+	// * a nonexistent object, or
+	// * an unsupported resource or kind, or
+	// * an existing resource but the data within that resource is malformed.
 	GatewayClassReasonInvalidParameters GatewayClassConditionReason = "InvalidParameters"
 
 	// This reason is used with the "Accepted" condition when the