update api and docs

Author: salonichf5

apis/v1alpha1/snippetsfilter_types.go

@@ -80,9 +80,9 @@ const (
 
 // SnippetsFilterStatus defines the state of SnippetsFilter.
 type SnippetsFilterStatus struct {
-	// Controllers describe the state of the SnippetsFilter and controller name.
-	// +optional
-	// +listType=map
+	// Controllers is a list of Gateway API controllers that processed the SnippetsFilter
+	// and the status of the SnippetsFilter with respect to each controller.
+	//
 	// +kubebuilder:validation:MaxItems=16
 	Controllers []ControllerStatus `json:"controllers,omitempty"`
 }
@@ -105,6 +105,7 @@ type ControllerStatus struct {
 
 	// Conditions describe the status of the SnippetsFilter.
 	//
+	// +optional
 	// +listType=map
 	// +listMapKey=type
 	// +kubebuilder:validation:MinItems=1

config/crd/bases/gateway.nginx.org_snippetsfilters.yaml

@@ -87,8 +87,9 @@ spec:
             description: Status defines the state of the SnippetsFilter.
             properties:
               controllers:
-                description: Controllers describe the state of the SnippetsFilter
-                  and controller name.
+                description: |-
+                  Controllers is a list of Gateway API controllers that processed the SnippetsFilter
+                  and the status of the SnippetsFilter with respect to each controller.
                 items:
                   properties:
                     conditions:
@@ -178,7 +179,6 @@ spec:
                   type: object
                 maxItems: 16
                 type: array
-                x-kubernetes-list-type: map
             type: object
         required:
         - spec

site/content/reference/api.md

@@ -860,6 +860,7 @@ longer necessary.</p>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
 <p>Conditions describe the status of the SnippetsFilter.</p>
 </td>
 </tr>
@@ -1364,8 +1365,8 @@ Allowed contexts: main, http, http.server, http.server.location.</p>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Controllers describe the state of the SnippetsFilter and controller name.</p>
+<p>Controllers is a list of Gateway API controllers that processed the SnippetsFilter
+and the status of the SnippetsFilter with respect to each controller.</p>
 </td>
 </tr>
 </tbody>