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 052c6c520476f9ab16402906244e6f31440cb4d1..5298c0d318e996461fc9463aa6e64574ad569533 100644 (file)
--- 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 9ca58f56e21b6588c960be0b75a3c376201eb771..fca375089600a9d3ef50a14cd82125f06813a79d 100644 (file)
--- 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 (file)
index 0000000..a5da2cf
--- /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.