From: Jason Ish <jason.ish@oisf.net>
Date: Thu, 16 Oct 2025 22:52:27 +0000 (-0600)
Subject: doc/userguide: add a known issues page
X-Git-Tag: suricata-8.0.2~32
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F14073%2Fhead;p=thirdparty%2Fsuricata.git

doc/userguide: add a known issues page

The idea of this page is to track known issues on a release branch
that we do not plan to fix.
---

diff --git a/doc/userguide/Makefile.am b/doc/userguide/Makefile.am
index 052c6c5204..5298c0d318 100644
--- a/doc/userguide/Makefile.am
+++ b/doc/userguide/Makefile.am
@@ -13,6 +13,7 @@ EXTRA_DIST = \
 	firewall \
 	generate-evedoc.sh \
 	index.rst \
+	known-issues.rst \
 	upgrade \
 	upgrade.rst \
 	initscripts.rst \
diff --git a/doc/userguide/index.rst b/doc/userguide/index.rst
index 9ca58f56e2..fca3750896 100644
--- a/doc/userguide/index.rst
+++ b/doc/userguide/index.rst
@@ -37,3 +37,4 @@ This is the documentation for Suricata |version|.
    devguide/index.rst
    verifying-source-files
    appendix/index.rst
+   known-issues
diff --git a/doc/userguide/known-issues.rst b/doc/userguide/known-issues.rst
new file mode 100644
index 0000000000..a5da2cffd6
--- /dev/null
+++ b/doc/userguide/known-issues.rst
@@ -0,0 +1,9 @@
+Known Issues
+############
+
+The following is a list of known issues in Suricata 8.0.
+
+* When an IKE message contains multiple attributes with the same key,
+  only the first will be logged to avoid producing invalid JSON, or
+  introducing a logging format change. See
+  https://redmine.openinfosecfoundation.org/issues/7923.