From d2ca687d78f21fba08e18794be40db8b272db08b Mon Sep 17 00:00:00 2001 From: Wlodzimierz Wencel Date: Fri, 24 May 2024 08:13:35 +0000 Subject: [PATCH] [#3379] added instructions about new kea repositories --- doc/sphinx/arm/install.rst | 11 +++++++++++ doc/sphinx/arm/quickstart.rst | 7 ++++++- doc/sphinx/conf.py | 4 ++++ 3 files changed, 21 insertions(+), 1 deletion(-) diff --git a/doc/sphinx/arm/install.rst b/doc/sphinx/arm/install.rst index cb52b0a4b7..9d2cca94d6 100644 --- 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 `_. +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 a86dc077a6..9ece8adf34 100644 --- 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 `__. -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 b36ec1dd8a..f0ca589908 100644 --- 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. -- 2.47.2