doc/userguide: add a known issues page

jasonish · jasonish · commit 2bddc6f74dfd · 2025-10-20T12:27:24.000-06:00
The idea of this page is to track known issues on a release branch that we do not plan to fix. (cherry picked from commit a4f722f)
diff --git a/doc/userguide/Makefile.am b/doc/userguide/Makefile.am
@@ -9,6 +9,7 @@ EXTRA_DIST = \
 	devguide \
 	file-extraction \
 	index.rst \
+	known-issues.rst \
 	upgrade \
 	upgrade.rst \
 	initscripts.rst \
diff --git a/doc/userguide/index.rst b/doc/userguide/index.rst
@@ -34,4 +34,5 @@ This is the documentation for Suricata |version|.
    acknowledgements
    licenses/index.rst
    devguide/index.rst
-   verifying-source-files
+   verifying-source-files
+   known-issues
diff --git a/doc/userguide/known-issues.rst 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.
