From c5e70402dbb77d231d2c9302f516aebf602c20f5 Mon Sep 17 00:00:00 2001
From: Vitor Hideyoshi <vitor.h.n.batista@gmail.com>
Date: Tue, 19 Aug 2025 20:44:16 -0300
Subject: [PATCH] (feat): Adds Warning to Docs About Discriminator Keyword

---
 docs/source/usage.oneof.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/source/usage.oneof.rst b/docs/source/usage.oneof.rst
index a836df4..6e875a4 100644
--- a/docs/source/usage.oneof.rst
+++ b/docs/source/usage.oneof.rst
@@ -106,3 +106,7 @@ Examples
 .. warning::
 
     If your data could match multiple schemas in a oneOf, validation will fail. Ensure schemas are mutually exclusive.
+
+.. warning::
+
+    The discriminator feature is not officially in the JSON Schema specification, it was introduced by OpenAI. Use it with caution and ensure it fits your use case.