doc/user: adjust formulation on version compatibility for 6+ situation

diff --git a/NEWS b/NEWS
index 4379f77b38745729138b6674c2f4a0d918574273..78ced41d22dcdbd253b5220ae177bbe48e99946e 100644 (file)
--- 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 8a93bc778b5eb5d1e4ec1723a267b41945112c1e..0c11478668054727de43bab0dd4906eed8b39390 100644 (file)
--- 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