fix!: move minor+ version misalignment logging to debug-level

Fixes #1183

Author: metacosm

core/deployment/src/main/java/io/quarkiverse/operatorsdk/deployment/VersionAlignmentCheckingStep.java

@@ -61,10 +61,8 @@ private void checkVersionCompatibility(BuildTimeOperatorConfiguration buildTimeC
             } else {
                 final var diff = expectedVersion.diff(foundVersion);
                 if (diff.compareTo(VersionDiff.MINOR) >= 0) {
-                    log.warn(message
+                    log.debug(message
                             + " by at least a minor version and things might not work as expected.");
-                } else {
-                    log.debug(message);
                 }
             }
         }

core/runtime/src/main/java/io/quarkiverse/operatorsdk/runtime/BuildTimeOperatorConfiguration.java

@@ -61,7 +61,7 @@ public interface BuildTimeOperatorConfiguration {
     Boolean stopOnInformerErrorDuringStartup();
 
     /**
-     * Whether to fail or emit a debug-level (warning-level when misalignment is at the minor or above version level) log when
+     * Whether to fail or emit a debug-level (when misalignment is at the minor or above version level) log when
      * the extension detects that there are misaligned versions.
      * <p/>
      * The following versions are checked for alignment:
@@ -70,6 +70,15 @@ public interface BuildTimeOperatorConfiguration {
      * <li>Fabric8 client version used by JOSDK vs. actually used Fabric8 client version</li>
      * <li>Fabric8 client version used by Quarkus vs. actually used Fabric8 client version</li>
      * </ul>
+     * <p>
+     * Checking the alignment of these versions used to be more important than it is now as it happened that attempting to use
+     * this extension with differing versions of the client between JOSDK and Quarkus caused issues. Usually, this manifested
+     * with otherwise unexplained issues when using native compilation (e.g. improper serialization of objects) so version
+     * alignment check was implemented to help diagnose such issues.
+     * </p>
+     * Prior to version 7.3.0, this version alignment check was outputting warning-level information whenever versions were
+     * mismatched at least at the minor level, sometimes causing confusion. Since issues caused by such misalignments have been
+     * rare now that the project is more mature, it was decided to move these logs to debug-level instead.
      */
     @WithDefault("false")
     Boolean failOnVersionCheck();

docs/modules/ROOT/pages/includes/quarkus-operator-sdk.adoc

@@ -334,7 +334,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Whether to fail or emit a debug-level (warning-level when misalignment is at the minor or above version level) log when the extension detects that there are misaligned versions.
+Whether to fail or emit a debug-level (when misalignment is at the minor or above version level) log when the extension detects that there are misaligned versions.
 
 The following versions are checked for alignment:
 
@@ -343,6 +343,10 @@ The following versions are checked for alignment:
  - Fabric8 client version used by Quarkus vs. actually used Fabric8 client version
 
 
+
+Checking the alignment of these versions used to be more important than it is now as it happened that attempting to use this extension with differing versions of the client between JOSDK and Quarkus caused issues. Usually, this manifested with otherwise unexplained issues when using native compilation (e.g. improper serialization of objects) so version alignment check was implemented to help diagnose such issues.  Prior to version 7.3.0, this version alignment check was outputting warning-level information whenever versions were mismatched at least at the minor level, sometimes causing confusion. Since issues caused by such misalignments have been rare now that the project is more mature, it was decided to move these logs to debug-level instead.
+
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPERATOR_SDK_FAIL_ON_VERSION_CHECK+++[]
 endif::add-copy-button-to-env-var[]

docs/modules/ROOT/pages/includes/quarkus-operator-sdk_quarkus.operator-sdk.adoc

@@ -334,7 +334,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-Whether to fail or emit a debug-level (warning-level when misalignment is at the minor or above version level) log when the extension detects that there are misaligned versions.
+Whether to fail or emit a debug-level (when misalignment is at the minor or above version level) log when the extension detects that there are misaligned versions.
 
 The following versions are checked for alignment:
 
@@ -343,6 +343,10 @@ The following versions are checked for alignment:
  - Fabric8 client version used by Quarkus vs. actually used Fabric8 client version
 
 
+
+Checking the alignment of these versions used to be more important than it is now as it happened that attempting to use this extension with differing versions of the client between JOSDK and Quarkus caused issues. Usually, this manifested with otherwise unexplained issues when using native compilation (e.g. improper serialization of objects) so version alignment check was implemented to help diagnose such issues.  Prior to version 7.3.0, this version alignment check was outputting warning-level information whenever versions were mismatched at least at the minor level, sometimes causing confusion. Since issues caused by such misalignments have been rare now that the project is more mature, it was decided to move these logs to debug-level instead.
+
+
 ifdef::add-copy-button-to-env-var[]
 Environment variable: env_var_with_copy_button:+++QUARKUS_OPERATOR_SDK_FAIL_ON_VERSION_CHECK+++[]
 endif::add-copy-button-to-env-var[]