docs: migration to 4.4

Author: csviri

Diff for: docs/_data/sidebar.yml

@@ -9,7 +9,7 @@
     url: /docs/glossary
   - title: Features
     url: /docs/features
-  - title: Dependent Resource Feature
+  - title: Dependent Resources
     url: /docs/dependent-resources
   - title: Workflows
     url: /docs/workflows
@@ -26,4 +26,8 @@
   - title: Migrating from v2 to v3
     url: /docs/v3-migration
   - title: Migrating from v3 to v3.1
-    url: /docs/v3-1-migration
+    url: /docs/v3-1-migration
+  - title: Migrating from v4.2 to v4.3
+    url: /docs/v4-3-migration
+  - title: Migrating from v4.3 to v4.4
+    url: /docs/v4-4-migration

Diff for: docs/documentation/v4-4-migration.md

@@ -0,0 +1,24 @@
+---
+title: Migrating from v4.3 to v4.4
+description: Migrating from v4.3 to v4.4
+layout: docs
+permalink: /docs/v4-4-migration
+---
+
+# Migrating from v4.4 to v4.4
+
+## Using SSA in Dependent Resources
+
+From this version by default [Dependent Resources](https://javaoperatorsdk.io/docs/dependent-resources) uses
+[Server Side Apply](https://kubernetes.io/docs/reference/using-api/server-side-apply/) to create and update
+Kubernetes resources. A
+new [default matching](https://github.com/java-operator-sdk/java-operator-sdk/blob/e95f9c8a8b8a8561c9a735e60fc5d82b7758df8e/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/processing/dependent/kubernetes/KubernetesDependentResource.java#L163-L163)
+algorithm is provided for `KubernetesDependentResource` that is based on `managedFields` of SSA. For details
+see [SSABasedGenericKubernetesResourceMatcher](https://github.com/java-operator-sdk/java-operator-sdk/blob/e95f9c8a8b8a8561c9a735e60fc5d82b7758df8e/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/processing/dependent/kubernetes/SSABasedGenericKubernetesResourceMatcher.java)
+
+Since those features are hard to completely test, we there are feature flags provided to use the legacy behavior,
+see those
+in [ConfigurationService](https://github.com/java-operator-sdk/java-operator-sdk/blob/e95f9c8a8b8a8561c9a735e60fc5d82b7758df8e/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationService.java#L268-L289)
+
+Note that it is possible to override the related methods/behavior on class level when extending
+the `KubernetesDependentResource`.