From 5ad540377272b0cf9a286c4930611f87eb392bc9 Mon Sep 17 00:00:00 2001
From: fabianallendorf <fabian.allendorf@node.energy>
Date: Thu, 27 Nov 2025 11:22:49 +0100
Subject: [PATCH] add warning to documentation

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

diff --git a/docs/source/usage.rst b/docs/source/usage.rst
index 738fad2..5824757 100644
--- a/docs/source/usage.rst
+++ b/docs/source/usage.rst
@@ -469,6 +469,14 @@ After:
 
 You can use this option to enable the legacy behavior.
 
+.. warning::
+
+    This reintroduces a known issue https://github.com/jazzband/django-auditlog/issues/421
+    Commission Error: Causes unnecessary LogEntries even though no update occurrs because the string representation in memory changed
+    Omission Error: More common problem, a related object is updated to another object with the same string representation, no update is logged
+
+    Beware of these problem when enabling this setting.
+
 .. versionadded:: 3.4.0
 
 Actors