docs: clarify uiautomator1 driver
MODIFY
docs/en/drivers/android-uiautomator.md
docs/en/drivers/android-uiautomator.md
@@ -27,7 +27,9 @@ The way to start a session using the UiAutomator driver is to include the
`platformName` [capability](#TODO) in your [new session request](#TODO), with
the value `Android`. Of course, you must also include appropriate
`platformVersion`, `deviceName`, and `app` capabilities, at a minimum. In the
-case of this driver, no `automationName` capability should be used.
+case of this driver, for Appium versions below `1.14.0` no `automationName`
+capability should be used, while for version `1.14.0` and above the `automationName`
+should be set to `UiAutomator1`.
It is highly recommended to also set the `appPackage` and `appActivity`
capabilities in order to let Appium know exactly which package and activity

MODIFY
docs/en/drivers/android-uiautomator2.md
docs/en/drivers/android-uiautomator2.md
@@ -20,6 +20,10 @@ In addition to Appium's general requirements:
* Java 8 installed and configured correctly for your platform
* Mac, Windows, or Linux OS with the ability to run the Android SDK
+Further, the UiAutomator2 driver does not support Android versions below 5.0
+(Lollipop, API level 21). If you are automating such versions, consider using
+the [UiAutomator driver](/docs/en/drivers/android-uiautomator.md);
+
### Usage
The way to start a session using the UiAutomator2 driver is to include the

MODIFY
docs/en/writing-running-appium/caps.md
docs/en/writing-running-appium/caps.md
@@ -38,7 +38,7 @@ These Capabilities span multiple drivers.
|Capability|Description|Values|
|----|-----------|-------|
-|`automationName`|Which automation engine to use|`Appium` (default) or `UiAutomator2` or `Espresso` for Android or `XCUITest` for iOS or `YouiEngine` for application built with You.i Engine|
+|`automationName`|Which automation engine to use|`Appium` (default), or `UiAutomator2`, `Espresso`, or `UiAutomator1` for Android, or `XCUITest` or `Instruments` for iOS, or `YouiEngine` for application built with You.i Engine|
|`platformName`|Which mobile OS platform to use|`iOS`, `Android`, or `FirefoxOS`|
|`platformVersion`|Mobile OS version|e.g., `7.1`, `4.4`|
|`deviceName`|The kind of mobile device or emulator to use|`iPhone Simulator`, `iPad Simulator`, `iPhone Retina 4-inch`, `Android Emulator`, `Galaxy S4`, etc.... On iOS, this should be one of the valid devices returned by instruments with `instruments -s devices`. On Android this capability is currently ignored, though it remains required.|

docs: clarify uiautomator1 driver (#13479)