Improve ClusterServiceVersion schema

Fixes #167
Add descriptions for kind, name, and version properties of APIResourceReference schema.

Author: TheRealJon

crds/operators.coreos.com_clusterserviceversions.yaml

@@ -127,10 +127,13 @@ spec:
                                 - version
                               properties:
                                 kind:
+                                  description: Kind of the referent
                                   type: string
                                 name:
+                                  description: Name of the CustomResourceDefinition for the referent, or an empty string when the referent is not a custom resource
                                   type: string
                                 version:
+                                  description: API version of the referent
                                   type: string
                           specDescriptors:
                             type: array
@@ -237,10 +240,13 @@ spec:
                                 - version
                               properties:
                                 kind:
+                                  description: Kind of the referent
                                   type: string
                                 name:
+                                  description: Name of the CustomResourceDefinition for the referent, or an empty string when the referent is not a custom resource
                                   type: string
                                 version:
+                                  description: API version of the referent
                                   type: string
                           specDescriptors:
                             type: array
@@ -351,10 +357,13 @@ spec:
                                 - version
                               properties:
                                 kind:
+                                  description: Kind of the referent
                                   type: string
                                 name:
+                                  description: Name of the CustomResourceDefinition for the referent, or an empty string when the referent is not a custom resource
                                   type: string
                                 version:
+                                  description: API version of the referent
                                   type: string
                           specDescriptors:
                             type: array
@@ -453,10 +462,13 @@ spec:
                                 - version
                               properties:
                                 kind:
+                                  description: Kind of the referent
                                   type: string
                                 name:
+                                  description: Name of the CustomResourceDefinition for the referent, or an empty string when the referent is not a custom resource
                                   type: string
                                 version:
+                                  description: API version of the referent
                                   type: string
                           specDescriptors:
                             type: array

crds/zz_defs.go

@@ -148,8 +148,11 @@ type APIServiceDescription struct {
 // APIResourceReference is a Kubernetes resource type used by a custom resource
 // +k8s:openapi-gen=true
 type APIResourceReference struct {
+	// Name of the CustomResourceDefinition for the referent, or an empty string when the referent is not a custom resource
 	Name    string `json:"name"`
+	// Kind of the referent
 	Kind    string `json:"kind"`
+	// API version of the referent
 	Version string `json:"version"`
 }