diff --git a/docs/spec/v1/helmrepositories.md b/docs/spec/v1/helmrepositories.md
index f129cee8f..97fdff2ec 100644
--- a/docs/spec/v1/helmrepositories.md
+++ b/docs/spec/v1/helmrepositories.md
@@ -153,6 +153,9 @@ A HelmRepository also needs a
 
 Possible values are `default` for a Helm HTTP/S repository, or `oci` for an OCI Helm repository.
 
+**Note:**: For improved support for OCI Helm charts, please use the
+[`OCIRepository`](ocirepositories.md) API.
+
 ### Provider
 
 `.spec.provider` is an optional field that allows specifying an OIDC provider used