Add Upgrade Notes for the recursor

diff --git a/docs/markdown/recursor/upgrading.md b/docs/markdown/recursor/upgrading.md
new file mode 100644 (file)
index 0000000..813eb6f
--- /dev/null
+++ b/docs/markdown/recursor/upgrading.md
@@ -0,0 +1,8 @@
+Before upgrading, it is advised to read the [changelog](../changelog.md).
+When upgrading several versions, please read **all** notes applying to the upgrade.
+
+# 4.0.0 to 4.0.1
+Two settings have changed defaults, these new defaults decrease CPU usage:
+
+ - [`root-nx-trust`](settings.md#root-nx-trust) changed from `no` to `yes`
+ - [`log-common-errors`](settings.md#log-common-errors) changed from `yes` to `no`

diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index a91ca1c49ce65aafc87e5c2b3c258a8e69dee3bb..0bd37f0644894890b9e9f48a4f9c8faa790c895b 100644 (file)
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -58,6 +58,7 @@ pages:
     - Deprecated Backends: authoritative/backend-deprecated.md
   - Recursor:
     - Introduction: recursor/index.md
+    - Upgrade Notes: recursor/upgrading.md
     - Security of the Recursor: recursor/security.md
     - DNSSEC in the Recursor: recursor/dnssec.md
     - Recursor Statistics: recursor/stats.md