[#3379] added instructions about new kea repositories

diff --git a/doc/sphinx/arm/install.rst b/doc/sphinx/arm/install.rst
index cb52b0a4b7e16a66d6eb6d58083af834de5b4437..9d2cca94d6d4b451d0e16316d3497066721fbb52 100644 (file)
--- a/doc/sphinx/arm/install.rst
+++ b/doc/sphinx/arm/install.rst
@@ -18,6 +18,17 @@ go to https://cloudsmith.io/~isc/repos, choose the desired Kea version,
 and then click the "Set Me Up" button. For detailed
 instructions, please refer to this `Knowledgebase article <https://kb.isc.org/docs/isc-kea-packages>`_.
 
+ISC maintains two types of repositories: stable and development.
+The stable repositories contain a single stable release (e.g.,
+kea-2-4 or kea-2-6) along with all its maintenance updates.
+Separate repositories were introduced to minimize the risk of
+unintentionally upgrading from one stable release to another.
+
+The development repository, kea-dev, includes current and
+future development releases, which ISC does not recommend
+for production use. Packages in the kea-dev repository are
+subject to cleanup, and older versions may be removed.
+
 Installation From Cloudsmith Packages
 -------------------------------------
 ISC provides Kea packages for Alpine, Debian, Fedora, RHEL, and Ubuntu.

diff --git a/doc/sphinx/arm/quickstart.rst b/doc/sphinx/arm/quickstart.rst
index a86dc077a64560a425dc78fb4f6a96bc89feed55..9ece8adf34c5746bcf7ee81433c2c2bf6a52af59 100644 (file)
--- a/doc/sphinx/arm/quickstart.rst
+++ b/doc/sphinx/arm/quickstart.rst
@@ -58,7 +58,12 @@ easier to install Kea using native packages.
 
 1. Go to `Kea on cloudsmith.io <https://cloudsmith.io/~isc/repos/>`__.
 
-2. Choose the Cloudsmith repository e.g. |cloudsmith_repo| for Kea |version|.
+2. Choose the Cloudsmith repository e.g. |cloudsmith_repo| for Kea |version|. Or kea-2-4 for Kea 2.4.
+
+.. note::
+  All stable releases are stored in separate repositories, such as kea-2-4, kea-2-6, and so on.
+  All development releases, which are not recommended for production use,
+  are located in the kea-dev repository.
 
 3. Click on the arrow beside the "Set Me Up" button and select the desired OS flavor:
    Alpine, Debian, or RedHat.

diff --git a/doc/sphinx/conf.py b/doc/sphinx/conf.py
index b36ec1dd8ac79ad1d580db153d9cebd6ca71417a..f0ca58990844d63f0f232c944ccc5ececa7e8ff3 100644 (file)
--- a/doc/sphinx/conf.py
+++ b/doc/sphinx/conf.py
@@ -47,6 +47,10 @@ with open(config_ac_path) as f:
 version = release
 dashed_version_series='-'.join(version.split('.')[0:2])
 
+# now let's replace versions with odd minor number with dev
+if int(dashed_version_series[-1]) % 2 != 0:
+    dashed_version_series = 'dev'
+
 # -- General configuration ---------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.