Add extra info about SecurityContext field for CatalogSources

Author: camilamacedo86

crds/operators.coreos.com_catalogsources.yaml

@@ -1025,6 +1025,9 @@ spec:
                         will be configured as if `restricted` was specified. Otherwise, it will be configured as if `legacy` was
                         specified. Specifying a value other than `legacy` or `restricted` result in a validation error. When using older
                         catalog images, which can not run in `restricted` mode, the SecurityContextConfig should be set to `legacy`.
+                        Important, Catalog Sources built with OPM versions < v1.21.0 will not be able to run in `restricted` mode, and should
+                        be set to `legacy`. Catalog Sources built with OPM versions >= v1.21.0 will be able to run in `restricted` mode,
+                        OLM releases >= v1.32.0 can only accept the restricted mode and will not accept the legacy mode.
 
                         More information about PSA can be found here: https://kubernetes.io/docs/concepts/security/pod-security-admission/
                       type: string

pkg/operators/v1alpha1/catalogsource_types.go

@@ -133,6 +133,9 @@ type GrpcPodConfig struct {
 	// will be configured as if `restricted` was specified. Otherwise, it will be configured as if `legacy` was
 	// specified. Specifying a value other than `legacy` or `restricted` result in a validation error. When using older
 	// catalog images, which can not run in `restricted` mode, the SecurityContextConfig should be set to `legacy`.
+	// Important, Catalog Sources built with OPM versions < v1.21.0 will not be able to run in `restricted` mode, and should
+	// be set to `legacy`. Catalog Sources built with OPM versions >= v1.21.0 will be able to run in `restricted` mode,
+	// OLM releases >= v1.32.0 can only accept the restricted mode and will not accept the legacy mode.
 	//
 	// More information about PSA can be found here: https://kubernetes.io/docs/concepts/security/pod-security-admission/
 	// +optional