From: Daniel Salzman <daniel.salzman@nic.cz>
Date: Tue, 2 Sep 2025 14:02:13 +0000 (+0200)
Subject: doc: rework mod-cookies examples
X-Git-Tag: v3.5.0~18
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f8ea2b2d98587dcd4d099b41eb6868f77db9b3bd;p=thirdparty%2Fknot-dns.git

doc: rework mod-cookies examples
---

diff --git a/src/knot/modules/cookies/cookies.rst b/src/knot/modules/cookies/cookies.rst
index c767a25e9f..94af841331 100644
--- a/src/knot/modules/cookies/cookies.rst
+++ b/src/knot/modules/cookies/cookies.rst
@@ -25,29 +25,20 @@ It is recommended to enable DNS Cookies globally, not per zone. The module may b
 
     template:
         - id: default
-          global-module: mod-cookies # Enable DNS Cookies globally
+          global-module: mod-cookies  # Enable DNS Cookies globally with defaults
 
 Module configuration may be supplied if necessary.
 
 ::
 
     mod-cookies:
-      - id: default
-        secret-lifetime: 30h # The Server Secret is regenerated every 30 hours
-        badcookie-slip: 3    # The server replies only to every third query with a wrong cookie
+      - id: custom
+        badcookie-slip: 3  # The server replies only to every third query with a wrong cookie
+        secret: 0xdeadbeefdeadbeefdeadbeefdeadbeef  # Explicit Server Secret
 
     template:
       - id: default
-        global-module: mod-cookies/default # Enable DNS Cookies globally
-
-The value of the Server Secret may also be managed manually using the :ref:`mod-cookies_secret` option. In this case
-the server does not automatically regenerate the Server Secret.
-
-::
-
-    mod-cookies:
-        - id: default
-          secret: 0xdeadbeefdeadbeefdeadbeefdeadbeef
+        global-module: mod-cookies/custom  # Enable DNS Cookies globally with custom settings
 
 Module reference
 ----------------