diff --git a/content/en/configuration/minify.md b/content/en/configuration/minify.md
index a530cb73d..3f010f974 100644
--- a/content/en/configuration/minify.md
+++ b/content/en/configuration/minify.md
@@ -10,6 +10,11 @@ This is the default configuration:
 
 {{< code-toggle config=minify />}}
 
-See the [tdewolff/minify] project page for details.
+See the [tdewolff/minify] project page for details, but note the following:
+
+- `css.inline` is for internal use. Changing this setting has no effect.
+- `css.keepCSS2` has been deprecated. Use `css.version` instead.
+- `html.keepConditionalComments` has been deprecated. Use `html.keepSpecialComments` instead.
+- `svg.inline` is for internal use. Changing this setting has no effect.
 
 [tdewolff/minify]: https://github.com/tdewolff/minify
diff --git a/data/docs.yaml b/data/docs.yaml
index cb66e05b0..2198d9c6f 100644
--- a/data/docs.yaml
+++ b/data/docs.yaml
@@ -1490,8 +1490,9 @@ config:
     tdewolff:
       css:
         inline: false
-        keepCSS2: true
+        keepCSS2: false
         precision: 0
+        version: 0
       html:
         keepComments: false
         keepConditionalComments: false