docs(rec): restructure documents in the TOC

diff --git a/pdns/recursordist/docs/appendices/index.rst b/pdns/recursordist/docs/appendices/index.rst
new file mode 100644 (file)
index 0000000..3d21eb1
--- /dev/null
+++ b/pdns/recursordist/docs/appendices/index.rst
@@ -0,0 +1,17 @@
+Appendices
+==========
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    compiling
+    crypto-export
+    EOL
+    FAQ
+    internals
+    structuredlogging
+    yamlconversion
+    ../manpages/index
+    ../common/license
+    ../security-advisories/index

diff --git a/pdns/recursordist/docs/config.rst b/pdns/recursordist/docs/config.rst
new file mode 100644 (file)
index 0000000..f9f231c
--- /dev/null
+++ b/pdns/recursordist/docs/config.rst
@@ -0,0 +1,18 @@
+Configuration
+=============
+
+Configuration of PowerDNS Recursor can be done in two ways. The recommended way (since version 5.2) is using :doc:`YAML <yamlsettings>`.
+The older method of a :doc:`settings file<settings>`, combined with a :doc:`Lua configuration <lua-config/index>` is supported, but no longer recommended.
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    yamlsettings
+    settings
+    lua-config/index
+    ../performance
+    ../dns64
+    ../dnssec
+    ../nod_udr
+    ../metrics

diff --git a/pdns/recursordist/docs/indexTOC.rst b/pdns/recursordist/docs/indexTOC.rst
index cf56e82f98ba22a321db88c4f66bc20e26bc010c..acf6e44f28998a351b311db2f3fb81053ec55295 100644 (file)
--- a/pdns/recursordist/docs/indexTOC.rst
+++ b/pdns/recursordist/docs/indexTOC.rst
@@ -2,26 +2,16 @@ PowerDNS Recursor
 =================
 
 .. toctree::
-    :maxdepth: 3
+    :maxdepth: 1
     :glob:
 
-    index
-    getting-started
-    running
-    dnssec
-    settings
-    yamlsettings
-    lua-config/index
-    lua-scripting/index
-    dns64
-    metrics
-    performance
-    manpages/index
-    http-api/index
-    security
-    security-advisories/index
-    upgrade
+    Overview <index>
+    Installation <getting-started>
+    Operation <running>
+    Upgrade Guide <upgrade>
+    config
+    Scripting <lua-scripting/index>
+    HTTP API <http-api/index>
+    Security <security>
     changelog/index
-    nod_udr
-    appendices/*
-    common/license
+    Appendices <appendices/index>