Fix docs

Fixes various issues in the docs. Mostly updates snippets to
reflect new fields from recent API changes.

Signed-off-by: Mikalai Radchuk <[email protected]>

Author: Mikalai Radchuk

config/samples/catalogd_operatorcatalog.yaml

@@ -7,4 +7,4 @@ spec:
     type: Image
     image:
       ref: quay.io/operatorhubio/catalog:latest
-      pollInterval: 10m
+      pollIntervalMinutes: 10

docs/concepts/crd-upgrade-safety.md

@@ -61,18 +61,18 @@ kind: ClusterExtension
 metadata:
     name: clusterextension-sample
 spec:
+    namespace: default
+    serviceAccount:
+      name: argocd-installer
     source:
       sourceType: Catalog
       catalog:
         packageName: argocd-operator
         version: 0.6.0
     install:
-      namespace: default
-      serviceAccount:
-        name: argocd-installer
       preflight:
         crdUpgradeSafety:
-          disabled: true
+          enforcement: "None"
 ```
 
 You cannot disable individual field validators. If you disable the CRD Upgrade Safety preflight check, all field validators are disabled.

docs/getting-started/olmv1_getting_started.md

@@ -2,7 +2,7 @@
 
 The following script will install OLMv1 on a Kubernetes cluster. If you don't have one, you can deploy a Kubernetes cluster with [KIND](https://sigs.k8s.io/kind).
 
-> [!CAUTION]  
+> [!CAUTION]
 > Operator-Controller depends on [cert-manager](https://cert-manager.io/). Running the following command
 > may affect an existing installation of cert-manager and cause cluster instability.
 
@@ -44,7 +44,7 @@ spec:
     type: Image
     image:
       ref: quay.io/operatorhubio/catalog:latest
-      pollInterval: 10m
+      pollIntervalMinutes: 10
 EOF
 ```
 
@@ -78,7 +78,7 @@ and on the extension upgrade process [here](../tutorials/upgrade-extension.md).
 
 ```bash
 # Update to v0.11.0
-kubectl patch clusterextension argocd --type='merge' -p '{"spec": {"source": {"content-management": {"version": "0.11.0"}}}}'
+kubectl patch clusterextension argocd --type='merge' -p '{"spec": {"source": {"catalog": {"version": "0.11.0"}}}}'
 
 ```
 
@@ -106,10 +106,10 @@ kubectl delete namespace argocd
 
 ```bash
 # Delete installer service account cluster roles
-kubectl delete clusterrole argocd-installer-clusterrole && kubectl delete clusterrole argocd-rbac-clusterrole
+kubectl delete clusterrole argocd-installer-clusterrole && kubectl delete clusterrole argocd-installer-rbac-clusterrole
 ```
 
 ```bash
 # Delete installer service account cluster role bindings
-kuebctl delete clusterrolebinding argocd-installer-binding && kubectl delete clusterrolebinding argocd-rbac-binding
+kubectl delete clusterrolebinding argocd-installer-binding && kubectl delete clusterrolebinding argocd-installer-rbac-binding
 ```

docs/howto/catalog-queries.md

@@ -12,61 +12,51 @@ curl -k https://localhost:8443/catalogs/operatorhubio/api/v1/all | <query>
 
 ## Package queries
 
-Available packages in a catalog
-: 
+Available packages in a catalog:
 ``` terminal
 jq -s '.[] | select( .schema == "olm.package")'
 ```
 
-Packages that support `AllNamespaces` install mode and do not use webhooks
-
-: 
+Packages that support `AllNamespaces` install mode and do not use webhooks:
 ``` terminal
 jq -c 'select(.schema == "olm.bundle") | {"package":.package, "version":.properties[] | select(.type == "olm.bundle.object").value.data |  @base64d | fromjson | select(.kind == "ClusterServiceVersion" and (.spec.installModes[] | select(.type == "AllNamespaces" and .supported == true) != null) and .spec.webhookdefinitions == null).spec.version}'
 ```
 
-Package metadata
-: 
+Package metadata:
 ``` terminal
 jq -s '.[] | select( .schema == "olm.package") | select( .name == "<package_name>")'
 ```
 
-Catalog blobs in a package
-: 
+Catalog blobs in a package:
 ``` terminal
 jq -s '.[] | select( .package == "<package_name>")'
 ```
 
 ## Channel queries
 
-Channels in a package
-: 
+Channels in a package:
 ``` terminal
 jq -s '.[] | select( .schema == "olm.channel" ) | select( .package == "<package_name>") | .name'
 ```
 
-Versions in a channel
-: 
+Versions in a channel:
 ``` terminal
 jq -s '.[] | select( .package == "<package_name>" ) | select( .schema == "olm.channel" ) | select( .name == "<channel_name>" ) | .entries | .[] | .name'
 ```
 
-Latest version in a channel and upgrade path
-: 
-``` terminal 
+Latest version in a channel and upgrade path:
+``` terminal
 jq -s '.[] | select( .schema == "olm.channel" ) | select ( .name == "<channel>") | select( .package == "<package_name>")'
 ```
 
 ## Bundle queries
 
-Bundles in a package
-: 
+Bundles in a package:
 ``` terminal
 jq -s '.[] | select( .schema == "olm.bundle" ) | select( .package == "<package_name>") | .name'
 ```
 
-Bundle dependencies and available APIs
-: 
+Bundle dependencies and available APIs:
 ``` terminal
 jq -s '.[] | select( .schema == "olm.bundle" ) | select ( .name == "<bundle_name>") | select( .package == "<package_name>")'
 ```

docs/tutorials/add-catalog.md

@@ -29,35 +29,33 @@ This catalog is distributed as an image [quay.io/operatorhubio/catalog](https://
     apiVersion: olm.operatorframework.io/v1alpha1
     kind: ClusterCatalog
     metadata:
-      name: operatorhubio
+      name: <catalog_name>
     spec:
       source:
         type: Image
         image:
           ref: <catalog_image>
-          pollInterval: <poll_interval_duration>
+          pollIntervalMinutes: <poll_interval_duration>
     ```
 
     `catalog_name`
     :   Specifies the image reference for the catalog you want to install, such as `quay.io/operatorhubio/catalog:latest`.
 
     `poll_interval_duration`
-    :   Specifies the interval for polling the remote registry for newer image digests.
-            The default value is `24h`.
-            Valid units include seconds (`s`), minutes (`m`), and hours (`h`).
-            To disable polling, set a zero value, such as `0s`.
+    :   Specifies the number of minutes for polling the remote registry for newer image digests.
+            This field is optional. To disable polling, unset the field.
 
     ``` yaml title="Example `operatorhubio.yaml` CR"
     apiVersion: olm.operatorframework.io/v1alpha1
     kind: ClusterCatalog
     metadata:
-      name: operatorhub
+      name: operatorhubio
     spec:
       source:
         type: Image
         image:
           ref: quay.io/operatorhubio/catalog:latest
-          pollInterval: 10m
+          pollIntervalMinutes: 10
     ```
 
 2. Apply the ClusterCatalog CR:
@@ -81,8 +79,8 @@ This catalog is distributed as an image [quay.io/operatorhubio/catalog](https://
         ```
 
         ``` terminal title="Example output"
-        NAME           LASTUNPACKED   AGE
-        operatorhubio  9m31s          9m55s
+        NAME            LASTUNPACKED   SERVING   AGE
+        operatorhubio   18s            True      27s
         ```
 
     * Check the status of your catalog:
@@ -99,40 +97,41 @@ This catalog is distributed as an image [quay.io/operatorhubio/catalog](https://
         API Version:  olm.operatorframework.io/v1alpha1
         Kind:         ClusterCatalog
         Metadata:
-        Creation Timestamp:  2024-10-02T19:51:24Z
-        Finalizers:
+          Creation Timestamp:  2024-11-11T13:19:12Z
+          Finalizers:
             olm.operatorframework.io/delete-server-cache
-        Generation:        1
-        Resource Version:  33321
-        UID:               52894532-0646-41a5-8285-c7f48bba49e4
+          Generation:        1
+          Resource Version:  2143
+          UID:               2cebaf11-7a5c-4813-bef3-58ac2e373057
         Spec:
-          Priority:  0
+          Availability Mode:  Available
+          Priority:           0
           Source:
             Image:
-              Poll Interval:  10m0s
-              Ref:            quay.io/operatorhubio/catalog:latest
-            Type:             Image
+              Poll Interval Minutes:  10
+              Ref:                    quay.io/operatorhubio/catalog:latest
+            Type:                     Image
         Status:
           Conditions:
-            Last Transition Time:  2024-03-12T19:35:34Z
+            Last Transition Time:  2024-11-11T13:19:21Z
             Message:               Successfully unpacked and stored content from resolved source
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Succeeded
-            Status:                False
+            Status:                True
             Type:                  Progressing
-            Last Transition Time:  2024-03-12T19:35:34Z
+            Last Transition Time:  2024-11-11T13:19:21Z
             Message:               Serving desired content from resolved source
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Available
             Status:                True
             Type:                  Serving
-          URLs:
-            Base:                  https://catalogd-server.olmv1-system.svc/catalogs/operatorhubio
-          Last Unpacked:           2024-03-12T19:35:34Z
+          Last Unpacked:           2024-11-11T13:19:21Z
           Resolved Source:
             Image:
-              Last Successful Poll Attempt:  2024-03-12T19:35:26Z
-              Ref:                           quay.io/operatorhubio/catalog@sha256:dee29aaed76fd1c72b654b9bc8bebc4b48b34fd8d41ece880524dc0c3c1c55ec
-            Type:                            Image
-        Events:                              <none>
+              Ref:  quay.io/operatorhubio/catalog@sha256:025cb23665449d8974102dda042c2e25bd3cb9138791971748f48d57c90a21d8
+            Type:   Image
+          Urls:
+            Base:  https://catalogd-service.olmv1-system.svc/catalogs/operatorhubio
+        Events:    <none>
+
         ```

docs/tutorials/install-extension.md

@@ -39,16 +39,15 @@ For information on determining the ServiceAccount's permission, please see [Deri
     metadata:
       name: <extension_name>
     spec:
+      namespace: <namespace_name>
+      serviceAccount:
+        name: <serviceAccount_name>
       source:
         sourceType: Catalog
         catalog:
           packageName: <package_name>
           channel: <channel>
           version: "<version>"
-      install:
-        namespace: <namespace_name>
-        serviceAccount:
-          name: <serviceAccount_name>
     ```
 
      `extension_name`
@@ -63,10 +62,10 @@ For information on determining the ServiceAccount's permission, please see [Deri
      `version`
      : Optional: Specifies the version or version range you want installed, such as `1.3.1` or `"<2"`.
      If you use a comparison string to define a version range, the string must be surrounded by double quotes (`"`).
-    
+
     `namespace_name`
-    : Specifies a name for the namespace in which the bundle of content for the package referenced 
-    in the packageName field will be applied. 
+    : Specifies a name for the namespace in which the bundle of content for the package referenced
+    in the packageName field will be applied.
 
     `serviceAccount_name`
     : serviceAccount name is a required reference to a ServiceAccount that exists
@@ -110,66 +109,64 @@ For information on determining the ServiceAccount's permission, please see [Deri
         API Version:  olm.operatorframework.io/v1alpha1
         Kind:         ClusterExtension
         Metadata:
-        Creation Timestamp:  2024-10-03T16:02:40Z
-        Finalizers:
+          Creation Timestamp:  2024-11-11T13:41:23Z
+          Finalizers:
             olm.operatorframework.io/cleanup-unpack-cache
             olm.operatorframework.io/cleanup-contentmanager-cache
-        Generation:        2
-        Resource Version:  1174
-        UID:               0fcaf3f5-d142-4c7e-8d88-c88a549f7764
+          Generation:        1
+          Resource Version:  5426
+          UID:               bde55f03-abe2-48af-8c09-28d32df878ad
         Spec:
-        Install:
-            Namespace:  argocd
-            Service Account:
+          Namespace:  argocd
+          Service Account:
             Name:  argocd-installer
-        Source:
+          Source:
             Catalog:
-            Package Name:  argocd-operator
-            Selector:
-            Upgrade Constraint Policy:  CatalogProvided
-            Version:                    0.6.0
+              Package Name:               argocd-operator
+              Upgrade Constraint Policy:  CatalogProvided
+              Version:                    0.6.0
             Source Type:                  Catalog
         Status:
-        Conditions:
-            Last Transition Time:  2024-10-03T16:02:41Z
+          Conditions:
+            Last Transition Time:  2024-11-11T13:41:23Z
             Message:
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Deprecated
             Status:                False
             Type:                  Deprecated
-            Last Transition Time:  2024-10-03T16:02:41Z
+            Last Transition Time:  2024-11-11T13:41:23Z
             Message:
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Deprecated
             Status:                False
             Type:                  PackageDeprecated
-            Last Transition Time:  2024-10-03T16:02:41Z
+            Last Transition Time:  2024-11-11T13:41:23Z
             Message:
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Deprecated
             Status:                False
             Type:                  ChannelDeprecated
-            Last Transition Time:  2024-10-03T16:02:41Z
+            Last Transition Time:  2024-11-11T13:41:23Z
             Message:
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Deprecated
             Status:                False
             Type:                  BundleDeprecated
-            Last Transition Time:  2024-10-03T16:02:43Z
+            Last Transition Time:  2024-11-11T13:41:31Z
             Message:               Installed bundle quay.io/operatorhubio/argocd-operator@sha256:d538c45a813b38ef0e44f40d279dc2653f97ca901fb660da5d7fe499d51ad3b3 successfully
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Succeeded
             Status:                True
             Type:                  Installed
-            Last Transition Time:  2024-10-03T16:02:43Z
+            Last Transition Time:  2024-11-11T13:41:32Z
             Message:               desired state reached
-            Observed Generation:   2
+            Observed Generation:   1
             Reason:                Succeeded
-            Status:                False
+            Status:                True
             Type:                  Progressing
-        Install:
+          Install:
             Bundle:
-            Name:     argocd-operator.v0.6.0
-            Version:  0.6.0
+              Name:     argocd-operator.v0.6.0
+              Version:  0.6.0
         Events:         <none>
         ```