Merge 4f83d5a60b into 08ab561429

The crd-ref-docs tool v0.3.0 started rendering `+optional` Go markers as
`Optional: {}` in API documentation's validation column. This appeared
as redundant empty JSON objects since the Required column already
conveyed this information. The PR updates the documentation template to
filter these markers while keeping meaningful validation rules like
patterns and enums, and removes unnecessary customMarkers configuration.

Closes #722

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>

Taskfile.yml

@@ -86,7 +86,7 @@ tasks:
       # renovate: datasource=git-refs depName=crd-gen-refs lookupName=https://github.com/cloudnative-pg/daggerverse currentValue=main
       DAGGER_CRDGENREF_SHA: ee59e34a99940e45f87a16177b1d640975b05b74
       # renovate: datasource=go depName=github.com/elastic/crd-ref-docs
-      CRDREFDOCS_VERSION: v0.2.0
+      CRDREFDOCS_VERSION: v0.3.0
     cmds:
       - >
         GITHUB_REF= dagger -s call -m github.com/cloudnative-pg/daggerverse/crd-ref-docs@${DAGGER_CRDGENREF_SHA}

hack/crd-gen-refs/config.yaml

@@ -1,9 +1,6 @@
 processor:
   ignoreGroupVersions:
     - "GVK"
-  customMarkers:
-    - name: "optional"
-      target: field
   ignoreFields:
 #    - "status$"
     - "TypeMeta$"

hack/crd-gen-refs/markdown/type.tpl

@@ -31,7 +31,7 @@ _Appears in:_
 {{ end -}}
 
 {{ range $type.Members -}}
-| `{{ .Name  }}` _{{ markdownRenderType .Type }}_ | {{ template "type_members" . }} | {{ if not .Markers.optional -}}True{{- end }} | {{ markdownRenderDefault .Default }} | {{ range .Validation -}} {{ markdownRenderFieldDoc . }} <br />{{ end }} |
+| `{{ .Name  }}` _{{ markdownRenderType .Type }}_ | {{ template "type_members" . }} | {{ if not .Markers.optional -}}True{{- end }} | {{ markdownRenderDefault .Default }} | {{ range .Validation -}}{{- $v := markdownRenderFieldDoc . }}{{- if and $v (ne $v "Optional: \\{\\}") -}} {{ $v }} <br />{{ end }}{{- end }} |
 {{ end -}}
 
 {{ end -}}

web/docs/installation.mdx

@@ -56,6 +56,8 @@ Both checks are required before proceeding with the installation.
 
 import { InstallationSnippet } from '@site/src/components/Installation';
 
+### Directly using the manifest
+
 Install the plugin using `kubectl` by applying the manifest for the latest
 release:
 
@@ -98,6 +100,18 @@ deployment "barman-cloud" successfully rolled out
 
 This confirms that the plugin is deployed and ready to use.
 
+### Using the Helm Chart
+
+The plugin can be installed using the provided [Helm chart](https://github.com/cloudnative-pg/charts/tree/main/charts/plugin-barman-cloud):
+
+```sh
+helm repo add cnpg https://cloudnative-pg.github.io/charts
+helm upgrade --install barman-cloud \
+  --namespace cnpg-system \
+  --create-namespace \
+  cnpg/plugin-barman-cloud
+```
+
 ## Testing the latest development snapshot
 
 You can also test the latest development snapshot of the plugin with the

web/versioned_docs/version-0.10.0/installation.mdx

@@ -56,6 +56,8 @@ Both checks are required before proceeding with the installation.
 
 import { InstallationSnippet } from '@site/src/components/Installation';
 
+### Directly using the manifest
+
 Install the plugin using `kubectl` by applying the manifest for the latest
 release:
 
@@ -98,6 +100,19 @@ deployment "barman-cloud" successfully rolled out
 
 This confirms that the plugin is deployed and ready to use.
 
+### Using the Helm Chart
+
+The plugin can be installed using the provided [Helm chart](https://github.com/cloudnative-pg/charts/tree/main/charts/plugin-barman-cloud):
+
+```sh
+helm repo add cnpg https://cloudnative-pg.github.io/charts
+helm upgrade --install barman-cloud \
+  --namespace cnpg-system \
+  --create-namespace \
+  --version 0.4.0 \
+  cnpg/plugin-barman-cloud
+```
+
 ## Testing the latest development snapshot
 
 You can also test the latest development snapshot of the plugin with the

web/versioned_docs/version-0.5.0/installation.mdx

@@ -56,6 +56,8 @@ Both checks are required before proceeding with the installation.
 
 import { InstallationSnippet } from '@site/src/components/Installation';
 
+### Directly using the manifest
+
 Install the plugin using `kubectl` by applying the manifest for the latest
 release:
 
@@ -98,6 +100,19 @@ deployment "barman-cloud" successfully rolled out
 
 This confirms that the plugin is deployed and ready to use.
 
+### Using the Helm Chart
+
+The plugin can be installed using the provided [Helm chart](https://github.com/cloudnative-pg/charts/tree/main/charts/plugin-barman-cloud):
+
+```sh
+helm repo add cnpg https://cloudnative-pg.github.io/charts
+helm upgrade --install barman-cloud \
+  --namespace cnpg-system \
+  --create-namespace \
+  --version 0.1.0 \
+  cnpg/plugin-barman-cloud
+```
+
 ## Testing the latest development snapshot
 
 You can also test the latest development snapshot of the plugin with the

web/versioned_docs/version-0.7.0/installation.mdx

@@ -56,6 +56,8 @@ Both checks are required before proceeding with the installation.
 
 import { InstallationSnippet } from '@site/src/components/Installation';
 
+### Directly using the manifest
+
 Install the plugin using `kubectl` by applying the manifest for the latest
 release:
 
@@ -98,6 +100,19 @@ deployment "barman-cloud" successfully rolled out
 
 This confirms that the plugin is deployed and ready to use.
 
+### Using the Helm Chart
+
+The plugin can be installed using the provided [Helm chart](https://github.com/cloudnative-pg/charts/tree/main/charts/plugin-barman-cloud):
+
+```sh
+helm repo add cnpg https://cloudnative-pg.github.io/charts
+helm upgrade --install barman-cloud \
+  --namespace cnpg-system \
+  --create-namespace \
+  --version 0.2.0 \
+  cnpg/plugin-barman-cloud
+```
+
 ## Testing the latest development snapshot
 
 You can also test the latest development snapshot of the plugin with the

web/versioned_docs/version-0.9.0/installation.mdx

@@ -56,6 +56,8 @@ Both checks are required before proceeding with the installation.
 
 import { InstallationSnippet } from '@site/src/components/Installation';
 
+### Directly using the manifest
+
 Install the plugin using `kubectl` by applying the manifest for the latest
 release:
 
@@ -98,6 +100,19 @@ deployment "barman-cloud" successfully rolled out
 
 This confirms that the plugin is deployed and ready to use.
 
+### Using the Helm Chart
+
+The plugin can be installed using the provided [Helm chart](https://github.com/cloudnative-pg/charts/tree/main/charts/plugin-barman-cloud):
+
+```sh
+helm repo add cnpg https://cloudnative-pg.github.io/charts
+helm upgrade --install barman-cloud \
+  --namespace cnpg-system \
+  --create-namespace \
+  --version 0.3.1 \
+  cnpg/plugin-barman-cloud
+```
+
 ## Testing the latest development snapshot
 
 You can also test the latest development snapshot of the plugin with the