From 465212844b5e11273295530147756423f39b90c9 Mon Sep 17 00:00:00 2001
From: Philipp <1062119+ptoews@users.noreply.github.com>
Date: Thu, 9 Jan 2025 11:27:47 +0100
Subject: [PATCH] docs(parsers.json_v2): Add warning about choosing XPath
 instead (#16373)

---
 plugins/parsers/json_v2/README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/plugins/parsers/json_v2/README.md b/plugins/parsers/json_v2/README.md
index 471352e06..fbf4ff839 100644
--- a/plugins/parsers/json_v2/README.md
+++ b/plugins/parsers/json_v2/README.md
@@ -7,6 +7,9 @@ this playground to test out your GJSON path here:
 [gjson.dev/](https://gjson.dev). You can find multiple examples under the
 [`testdata`][] folder.
 
+> [!WARNING]
+> In the current state of the implementation, the json_v2 parser should be avoided in favor of the [XPath Parser](../xpath), especially when working with arrays.
+
 ## Configuration
 
 ```toml