From 698dbf57f77493c350a9fb72b02e460e68abe0e7 Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Wed, 8 Nov 2023 15:36:49 +0900
Subject: [PATCH] docs: add notes to not recommened withRequest()

---
 user_guide_src/source/libraries/validation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/user_guide_src/source/libraries/validation.rst b/user_guide_src/source/libraries/validation.rst
index 6fc55822b71a..0e172d575f84 100644
--- a/user_guide_src/source/libraries/validation.rst
+++ b/user_guide_src/source/libraries/validation.rst
@@ -343,6 +343,10 @@ For example, data returned by multi select dropdown:
 withRequest()
 =============
 
+.. important:: This method exists only for backward compatibility. Do not use it
+    in new projects. Even if you are already using it, we recommend that you use
+    another, more appropriate method.
+
 .. warning:: If you want to validate POST data only, don't use ``withRequest()``.
     This method uses :ref:`$request->getVar() <incomingrequest-getting-data>`
     which returns ``$_GET``, ``$_POST`` or ``$_COOKIE`` data in that order