From: Vladimír Čunát Date: Thu, 8 Jan 2026 08:29:04 +0000 (+0100) Subject: doc/user: adjust formulation on version compatibility for 6+ situation X-Git-Tag: v6.1.0^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2d84dcd02ea1796771abd418fff7549c3cffe815;p=thirdparty%2Fknot-resolver.git doc/user: adjust formulation on version compatibility for 6+ situation --- diff --git a/NEWS b/NEWS index 4379f77b3..78ced41d2 100644 --- a/NEWS +++ b/NEWS @@ -1,7 +1,7 @@ Knot Resolver 6.1.0 (2026-01-08) ================================ -6.1.0 is the first officially stable release of version 6. +6.1.0 is the first officially stable release of version 6. As of this release, version 6 is preferred over version 5. Improvements: diff --git a/doc/user/NEWS.rst b/doc/user/NEWS.rst index 8a93bc778..0c1147866 100644 --- a/doc/user/NEWS.rst +++ b/doc/user/NEWS.rst @@ -19,7 +19,7 @@ Major version * We might release a new major also when internal implementation details change significantly. Minor version - * Configuration stays compatible with the previous version, except for undocumented or very obscure options. + * YAML configuration stays compatible with the previous version, except for undocumented or Lua-level options. * Upgrade should be seamless for users who use modules shipped as part of Knot Resolver distribution. * Incompatible changes in internal APIs are allowed in minor versions. Users who develop or use custom modules (i.e. modules not distributed together with Knot Resolver) need to double check their modules for incompatibilities. @@ -30,7 +30,11 @@ Patch version * API for modules should be stable on best effort basis, i.e. API is very unlikely to break in patch releases. * Custom modules might need to be recompiled, i.e. ABI compatibility is not guaranteed. -This definition is not applicable to versions older than 5.2.0. +Exceptions +---------- + * The 6.0.x series was special. It was an "early access" phase after huge changes, + and smaller incompatible changes still did happen during 6.0.x. + * This definition is not applicable to versions older than 5.2.0. .. include:: ../../NEWS :end-before: 5.x branch longterm support