adding an example for semverFilter in the the documentation

Signed-off-by: Soule BA <[email protected]>

Author: souleb

docs/spec/v1beta2/ocirepositories.md

@@ -390,6 +390,37 @@ order to distribute the load more evenly when multiple OCIRepository objects are
 set up with the same interval. For more information, please refer to the
 [source-controller configuration options](https://fluxcd.io/flux/components/source/options/).
 
+### SemverFilter
+
+`.spec.ref.semverFilter` is an optional field to specify a SemVer filter to apply
+when fetching tags from the OCI repository. The filter is a regular expression
+that is applied to the tags fetched from the repository. Only tags that match
+the filter are considered for the semver range resolution.
+
+**Note:** The filter is only taken into account when the `.spec.ref.semver` field
+is set.
+
+```yaml
+---
+apiVersion: source.toolkit.fluxcd.io/v1beta2
+kind: OCIRepository
+metadata:
+  name: podinfo
+  namespace: default
+spec:
+  interval: 5m0s
+  url: oci://ghcr.io/stefanprodan/manifests/podinfo
+  ref:
+    # SemVer comparisons using constraints without a prerelease comparator will skip prerelease versions.
+    # Adding a `-0` suffix to the semver range will include prerelease versions.
+    semver: ">= 6.1.x-0"
+    semverFilter: ".*-rc.*"
+```
+
+In the above example, the controller fetches tags from the `ghcr.io/stefanprodan/manifests/podinfo`
+repository and filters them using the regular expression `.*-rc.*`. Only tags that
+contain the `-rc` suffix are considered for the semver range resolution.
+
 ### Timeout
 
 `.spec.timeout` is an optional field to specify a timeout for OCI operations