docs: structuring documentation into sections

diff --git a/manager/docs/configuration.rst b/manager/docs/configuration.rst
deleted file mode 100644 (file)
index 55f9f3f..0000000
--- a/manager/docs/configuration.rst
+++ /dev/null
@@ -1,44 +0,0 @@
-*************************
-Declarative configuration
-*************************
-
-.. contents::
-    :depth: 2
-    :local:
-
-Final documentation will be generated from configuration datamodel.
-This is just a raw proposal.
-
-server
-======
-
-.. envvar:: server:hostname: <str>
-
-    Detailed information probably from python docstring.
-
-network
-=======
-
-.. envvar:: network:interfaces: <list>
-
-    .. envvar:: listen: <ip-address>[@port]
-
-    .. envvar:: kind: <dns|xdp|dot|doh|control>
-
-        :default: dns
-
-    .. envvar:: freebind: <bool>
-
-        :default: false
-
-    Example:
-
-    .. code-block:: yaml
-
-        network:
-            interfaces:
-              - listen: eth0@53
-
-
-
-

diff --git a/manager/docs/index.rst b/manager/docs/index.rst
index db8f7220d39953a202b39fa17815c9b11b13ea5d..a654dee0fc150bd2232f23a9a7867e9c2e5c4eb5 100644 (file)
--- a/manager/docs/index.rst
+++ b/manager/docs/index.rst
@@ -6,8 +6,10 @@ Knot Resolver Manager
     :maxdepth: 2
     :caption: Manager:
 
-    getting-started
-    configuration
+    manager-introduction
+    manager-getting-started
+    manager-migration
+    manager-configuration
 
 ==================
 Indices and tables

diff --git a/manager/docs/manager-configuration.rst b/manager/docs/manager-configuration.rst
new file mode 100644 (file)
index 0000000..9b6731d
--- /dev/null
+++ b/manager/docs/manager-configuration.rst
@@ -0,0 +1,3 @@
+*************
+Configuration
+*************

diff --git a/manager/docs/getting-started.rst b/manager/docs/manager-getting-started.rst
similarity index 61%
rename from manager/docs/getting-started.rst
rename to manager/docs/manager-getting-started.rst
index 6c6f84a01b378e02c16cda35977afc60f4e36d0d..9c15309a5b1aa58b6bb6e57ac3e7d2972dd13c6c 100644 (file)
--- a/manager/docs/getting-started.rst
+++ b/manager/docs/manager-getting-started.rst
@@ -1,16 +1,13 @@
 ***************
-Getting started
+Getting Started
 ***************
 
 .. contents::
     :depth: 1
     :local:
 
-Introduction
+Installation
 ============
 
-How to use
+Management
 ==========
-
-Migration
-=========

diff --git a/manager/docs/manager-introduction.rst b/manager/docs/manager-introduction.rst
new file mode 100644 (file)
index 0000000..ad6540e
--- /dev/null
+++ b/manager/docs/manager-introduction.rst
@@ -0,0 +1,3 @@
+************
+Introduction
+************

diff --git a/manager/docs/manager-migration.rst b/manager/docs/manager-migration.rst
new file mode 100644 (file)
index 0000000..1e4a0e7
--- /dev/null
+++ b/manager/docs/manager-migration.rst
@@ -0,0 +1,3 @@
+*********
+Migration
+*********