add readme notes

README.md

@@ -51,6 +51,8 @@ When you add a new CRD make sure to
 - Add CRD validation tests in [`test/crdsvalidation`][testcrdsvalidation]
 - If this CRD is meant to have Konnect helpers functions generated for it,
   add it in [konnect-funcs supported type list][konnect_funcs_gen].
+- Annotate the CRD and any new type it depends on with the right markers to make sure it will be included 
+  in the generated documentation. See [available markers](#Available custom markers).
 
 [crd_kustomization]: ./config/crd/kustomization.yaml
 [konnect_funcs_gen]: ./scripts/konnect-funcs/supportedtypes.go
@@ -59,3 +61,12 @@ When you add a new CRD make sure to
 
 Currently in order to make a new release/tag available for users to use is to
 create a new tag and push it to the repository.
+
+## Available custom markers
+
+| Name                        | Applies to | Meaning                                                                                                       |
+|-----------------------------|------------|---------------------------------------------------------------------------------------------------------------|
+| `+apireference:kgo:exclude` | Fields     | Any field annotated with this marker will be excluded from the [KGO's generated CRDs reference][kgo-crd-ref]. |
+| `+apireference:kgo:include` | Types      | Any type annotated with this marker will be included in the [KGO's generated CRDs reference][kgo-crd-ref].    |
+
+[kgo-crd-ref]: https://github.com/Kong/gateway-operator/blob/main/docs/api-reference.md

api/configuration/v1/kongplugin_types.go

@@ -64,7 +64,7 @@ type KongPlugin struct {
 	// such as AWS credentials in the Lambda plugin or the client secret in the OIDC plugin.
 	// Only one of `config` or `configFrom` may be used in a KongPlugin, not both at once.
 	//
-	// +apireference:kgo:exclude // KGO does not support this field.
+	// +apireference:kgo:exclude
 	ConfigFrom *ConfigSource `json:"configFrom,omitempty"`
 
 	// ConfigPatches represents JSON patches to the configuration of the plugin.
@@ -74,7 +74,7 @@ type KongPlugin struct {
 	// When Config is specified, patches will be applied to the configuration in Config.
 	// Otherwise, patches will be applied to an empty object.
 	//
-	// +apireference:kgo:exclude // KGO does not support this field.
+	// +apireference:kgo:exclude
 	ConfigPatches []ConfigPatch `json:"configPatches,omitempty"`
 
 	// PluginName is the name of the plugin to which to apply the config.