From 1dc19126a9c44f9490a16741598ec66d2eaa8a86 Mon Sep 17 00:00:00 2001
From: Camila Macedo <camilamacedo86@gmail.com>
Date: Sun, 15 Sep 2024 18:18:58 +0100
Subject: [PATCH] doc add note to clarify markers in the doc

---
 docs/book/src/reference/markers/crd-validation.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/book/src/reference/markers/crd-validation.md b/docs/book/src/reference/markers/crd-validation.md
index 3307cc6b5d1..9064bc10432 100644
--- a/docs/book/src/reference/markers/crd-validation.md
+++ b/docs/book/src/reference/markers/crd-validation.md
@@ -6,4 +6,16 @@ schema option.
 
 See [Generating CRDs](/reference/generating-crd.md) for examples.
 
+<aside class="note">
+<h1>Understanding Marker Grouping in Documentation</h1>
+
+Certain markers may seem duplicated. However, these markers are grouped based on their context of use
+— such as fields, types, or arrays. For instance, a marker like `+kubebuilder:validation:Enum` can be applied to
+individual fields or array items, and this flexibility is reflected in the documentation.
+
+The grouping ensures clarity by showing how the same marker can be reused for different purposes.
+
+</aside>
+
+
 {{#markerdocs CRD validation}}