docs: Document the migration guide from v9 to v10 (#2331)

Author: mykola-mokhnach

README.md

@@ -6,6 +6,11 @@
 
 This is the Java language bindings for writing Appium Tests that conform to [WebDriver Protocol](https://w3c.github.io/webdriver/)
 
+
+## v9 to v10 Migration
+
+Follow the [v9 to v10 Migration Guide](./docs/v9-to-v10-migration-guide.md) to streamline the migration process.
+
 ## v8 to v9 Migration
 
 Since v9 the client only supports Java 11 and above.

docs/v9-to-v10-migration-guide.md

@@ -0,0 +1,17 @@
+This is the list of main changes between major versions 9 and 10 of Appium 
+java client. This list should help you to successfully migrate your 
+existing automated tests codebase.
+
+
+## The minimum supported Selenium version is set to 4.35.0
+
+- Selenium versions below 4.35.0 won't work with Appium java client 10+.
+Check the [Compatibility Matrix](../README.md#compatibility-matrix) for more
+details about versions compatibility.
+
+## Removed previously deprecated items
+
+- `org.openqa.selenium.remote.html5.RemoteLocationContext`, `org.openqa.selenium.html5.Location` and 
+  `org.openqa.selenium.html5.LocationContext` imports have been removed since they don't exist
+  in Selenium lib anymore. Use appropriate replacements from this library instead for APIs and 
+  interfaces that were using deprecated classes, like `io.appium.java_client.Location`.