diff --git a/doc/man/knot.conf.5in b/doc/man/knot.conf.5in
index c11545e96..f2578968c 100644
--- a/doc/man/knot.conf.5in
+++ b/doc/man/knot.conf.5in
@@ -1810,6 +1810,14 @@ more records depending on the keys available.
 .UNINDENT
 .UNINDENT
 .sp
+\fBWARNING:\fP
+.INDENT 0.0
+.INDENT 3.5
+The \fBdouble\-ds\fP value does not trigger double\-DS roll\-over method. That method is
+only suppored by Knot when performed manually, with unset \fI\%ksk\-submission\fP\&.
+.UNINDENT
+.UNINDENT
+.sp
 \fIDefault:\fP \fBrollover\fP
 .SS cds\-digest\-type
 .sp
diff --git a/doc/reference.rst b/doc/reference.rst
index 3a771ca67..fa9745fb4 100644
--- a/doc/reference.rst
+++ b/doc/reference.rst
@@ -2007,6 +2007,10 @@ Possible values:
    If the zone keys are managed manually, the CDS and CDNSKEY rrsets may contain
    more records depending on the keys available.
 
+.. WARNING::
+   The ``double-ds`` value does not trigger double-DS roll-over method. That method is
+   only suppored by Knot when performed manually, with unset :ref:`policy_ksk-submission-check`.
+
 *Default:* ``rollover``
 
 .. _policy_cds-digest-type: