docs/user-manual.txt: drop chapters with config-prereqs.txt and ci-farm-lxc-setup.txt, refer to qa-guide now (also from other docs) [networkupstools#2832]

Signed-off-by: Jim Klimov <[email protected]>

Author: jimklimov

INSTALL.nut.adoc

@@ -205,7 +205,7 @@ tests>>" section details some more hints about such workflow, including some
 The NUT linkdoc:packager-guide[Packager Guide], which presents the best
 practices for installing and integrating NUT, is also a good reading.
 
-The <<Config_Prereqs,Prerequisites for building NUT on different OSes>>
+The <<NUT_Config_Prereqs,Prerequisites for building NUT on different OSes>>
 document suggests prerequisite packages with tools and dependencies
 available and needed to build and test as much as possible of NUT on
 numerous platforms, written from perspective of CI testing (if you
@@ -463,7 +463,7 @@ ports involved, and to read the production configuration files).
 Pre-requisites
 ^^^^^^^^^^^^^^
 
-The <<Config_Prereqs,Prerequisites for building NUT on different OSes>>
+The <<NUT_Config_Prereqs,Prerequisites for building NUT on different OSes>>
 document details tools and dependencies that were added on NUT CI build
 environments, which now cover many operating systems. This should
 provide a decent starting point for the build on yours (PRs to update
@@ -857,7 +857,7 @@ and help would be welcome!
 It should currently be possible to build the codebase in native Windows
 with MSYS2/MinGW and cross-building from Linux with mingw (preferably
 in a Debian/Ubuntu container). Refer to
-link:config-prereqs.txt[Prerequisites for building NUT on different OSes]
+link:docs/config-prereqs.txt[Prerequisites for building NUT on different OSes]
 and link:scripts/Windows/README.adoc[scripts/Windows/README.adoc file]
 for respective build environment preparation instructions.
 

docs/asciidoc.conf

@@ -54,7 +54,7 @@
 #   base document name.
 # Example:
 #   linkdoc:user-manual[user manual,NUT_Security]
-#   linkdoc:user-manual[Prerequisites for building NUT on different OSes,Config_Prereqs,docs/config-prereqs.txt]
+#   linkdoc:qa-manual[Prerequisites for building NUT on different OSes,NUT_Config_Prereqs,docs/config-prereqs.txt]
 #   linkdoc:developer-guide[developer guide,_status_data]
 #   linksingledoc:FAQ[shopping tips,_which_ups_should_i_buy]
 

docs/ci-farm-lxc-setup.txt

@@ -223,7 +223,7 @@ Also note the container/system naming without underscore in "x86_64" --
    https://wiki.archlinux.org/title/Install_Arch_Linux_from_existing_Linux#Using_pacman_from_the_host_system
    for details.
    On a Debian/Ubuntu host, assumed ready for NUT builds per
-   linkdoc:user-manual[Prerequisites for building NUT on different OSes,Config_Prereqs,docs/config-prereqs.txt],
+   linkdoc:qa-manual[Prerequisites for building NUT on different OSes,NUT_Config_Prereqs,docs/config-prereqs.txt],
    it would start like this:
 +
 ------

docs/qa-guide.adoc

@@ -70,7 +70,15 @@ FIXME: Write the chapter text.
 Continuous Integration (NUT CI farm)
 ------------------------------------
 
-FIXME: Write the chapter intro text.
+[[CI_Farm_Notes]]
+CI Farm configuration notes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NOTE: This chapter contains information about NUT CI farm setup tricks
+that were applied at different times by the maintainer team to ensure
+regular builds and tests of the codebase.  Whether these are used in
+daily production today or not, similar setup should be possible locally
+on developer and contributor machines.
 
 Multiple FOSS CI providers and technologies
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -126,9 +134,9 @@ include::ci-farm-lxc-setup.txt[]
 
 :leveloffset: 0
 
-[[Config_Prereqs]]
-NUT build prerequisites
------------------------
+[[NUT_Config_Prereqs]]
+Prerequisites for building NUT on different OSes
+------------------------------------------------
 
 :leveloffset: 1
 

docs/user-manual.txt

@@ -260,9 +260,9 @@ include::cables.txt[]
 Appendix H: Configure options
 =============================
 
-NOTE: For more information about build environment setup, see chapters
-below about <<Config_Prereqs,Configuration prerequisites>>
-and <<CI_Farm_Notes,CI Farm configuration notes>>.
+NOTE: For more information about build environment setup, see chapters about
+linkdoc:qa-guide[Prerequisites for building NUT on different OSes,NUT_Config_Prereqs,docs/config-prereqs.txt]
+and linkdoc:qa-guide[Custom NUT CI farm build agents: LXC containers,CI_LXC,docs/ci-farm-lxc-setup.txt].
 
 include::configure.txt[]
 
@@ -279,23 +279,3 @@ Appendix J: Project history
 ===========================
 
 include::history.txt[]
-
-
-[[Config_Prereqs]]
-Appendix K: Prerequisites for building NUT on different OSes
-============================================================
-
-include::config-prereqs.txt[]
-
-
-[[CI_Farm_Notes]]
-Appendix L: CI Farm configuration notes
-=======================================
-
-NOTE: This chapter contains information about NUT CI farm setup tricks
-that were applied at different times by the maintainer team to ensure
-regular builds and tests of the codebase.  Whether these are used in
-daily production today or not, similar setup should be possible locally
-on developer and contributor machines.
-
-include::ci-farm-lxc-setup.txt[]