From 72ed761b4504fe7eecc4aa210e460cc41b481ad0 Mon Sep 17 00:00:00 2001
From: Jonas DOREL <20277513+jdorel@users.noreply.github.com>
Date: Sun, 8 Jun 2025 01:20:47 +0200
Subject: [PATCH] doc(kustomizations.md): link to faq/two-kustomizations

Signed-off-by: Jonas DOREL <20277513+jdorel@users.noreply.github.com>
---
 docs/spec/v1beta2/kustomizations.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/spec/v1beta2/kustomizations.md b/docs/spec/v1beta2/kustomizations.md
index 2a973d17..633d83ff 100644
--- a/docs/spec/v1beta2/kustomizations.md
+++ b/docs/spec/v1beta2/kustomizations.md
@@ -5,6 +5,10 @@ validating and applying Kustomize overlays or plain Kubernetes manifests.
 The `Kustomization` Custom Resource Definition is the
 counterpart of Kustomize' `kustomization.yaml` config file.
 
+**Note:** Do not confuse Kustomization with `apiVersion: source.toolkit.fluxcd.io/v1` (defined by Flux) from the
+one with `apiVersion: kustomize.config.k8s.io/v1beta1` (defined by Kustomize).
+See the related [faq entry](https://fluxcd.io/flux/faq/#are-there-two-kustomization-types).
+
 ## Example
 
 The following is an example of a Flux Kustomization that reconciles on the