From: Aleš Mrázek <ales.mrazek@nic.cz>
Date: Sun, 12 Feb 2023 19:30:02 +0000 (+0100)
Subject: doc: legacy chapter removed
X-Git-Tag: v6.0.1~11^2~1^2~12
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=81a90aa0600a68cbf5d6035fb9077003e98241de;p=thirdparty%2Fknot-resolver.git

doc: legacy chapter removed

- legacy approach moved to Use Cases chapter
- legacy approach renamed to Usage without the manager
---

diff --git a/doc/legacy.rst b/doc/advanced-no-manager.rst
similarity index 86%
rename from doc/legacy.rst
rename to doc/advanced-no-manager.rst
index e6f31bfcc..39888a619 100644
--- a/doc/legacy.rst
+++ b/doc/advanced-no-manager.rst
@@ -1,10 +1,10 @@
 .. SPDX-License-Identifier: GPL-3.0-or-later
 
-.. _legacy-approach:
+.. _advanced-no-manager:
 
-***************
-Legacy approach
-***************
+***********************************
+Advanced: Usage without the manager
+***********************************
 
 If you want to continue using Knot Resolver as before version ``6.0.0`` this is chapter for you.
 For new and less experienced users, we recommend using the newer approach starting in :ref:`Getting Started <gettingstarted-intro>` chapter.
@@ -15,11 +15,11 @@ There are a few downsides to using the legacy approach that need to be mentioned
 * manual process management
 
 
-.. _legacy-startup:
+.. _advanced-no-manager-startup:
 
-**************
-Daemon startup
-**************
+=======
+Startup
+=======
 
 The legacy way to start Knot Resolver is to run single instance of its resolving daemon manualy using ``kresd@`` systemd integration.
 The daemon is single thread process.
@@ -30,14 +30,14 @@ The daemon is single thread process.
 
 .. tip::
 
-    For more information about Systemd integration see man kresd.systemd.
+    For more information about ``systemd`` integration see ``man kresd.systemd``.
 
 
-.. _legacy-config:
+.. _advanced-no-manager-config:
 
-*****************
-Lua configuration
-*****************
+=============
+Configuration
+=============
 
 Legacy way to configure Knot Resolver is to paste your Lua code typically into ``/etc/knot-resolver/kresd.conf`` configuration script.
 The resolver's daemon is preconfigure to load this script when using ``kresd@`` systemd integration.
diff --git a/doc/gettingstarted-intro.rst b/doc/gettingstarted-intro.rst
index a33e91401..f27715d56 100644
--- a/doc/gettingstarted-intro.rst
+++ b/doc/gettingstarted-intro.rst
@@ -12,6 +12,8 @@ This chapter will introduce Knot Resolver and will guide you through :ref:`insta
 Introduction
 ************
 
+If you are an advanced user and want to use Knot Resolver like before version 6, you can switch to :ref:`usage without the manager <advanced-no-manager>`, for other users, it is recommended to stick to this chapter.
+
 ==================
 Basic architecture
 ==================
diff --git a/doc/index.rst b/doc/index.rst
index 86f7ed1a9..0136f7582 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -20,19 +20,13 @@ If you are a new user, please start with chapter for :ref:`getting started <gett
    gettingstarted-startup
    gettingstarted-config
 
-.. toctree::
-   :caption: Legacy
-   :name: legacy-chapter
-   :maxdepth: 1
-
-   legacy
-
 
 .. toctree::
-   :caption: Common Use Cases
+   :caption: Use Cases
    :name: usecases-chapter
    :maxdepth: 1
 
+   advanced-no-manager
    usecase-personal-resolver
    usecase-internal-resolver
    usecase-isp-resolver