From 368c76662580a4af14b49e81f491b1a0fc2a50d0 Mon Sep 17 00:00:00 2001
From: Adrien Boulay <adrien.boulay@numspot.com>
Date: Mon, 19 Aug 2024 16:03:23 +0200
Subject: [PATCH] docs: Add note to recommend use of folderRef instead of
 folderUID

---
 docs/docs/dashboards.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/docs/dashboards.md b/docs/docs/dashboards.md
index 19f0a2e3d..a91f58f24 100644
--- a/docs/docs/dashboards.md
+++ b/docs/docs/dashboards.md
@@ -368,6 +368,7 @@ spec:
 
 * Use a static UID as a folder reference
 
+
 ```yaml
 ---
 apiVersion: grafana.integreatly.org/v1beta1
@@ -415,6 +416,8 @@ spec:
 
 ## Custom folders
 
+> Note: This method is not recommended. Prefer to use the GrafanaFolder CR and `folderRef` field to declare a folder instead.
+
 In a standard scenario, the operator would use the namespace a CR is deployed to as a folder name in grafana. `folder` field can be used to set a custom folder name:
 
 ```yaml