Update update-appium-io.yml for Azure Pipelines

docs(1.x): Adds deprecation messages for appium.github.io/appium.io (#18591 )
* docs: add appium.io in the api.md path as a workaround * docs: add links to appium 2 related as workarounds
2026-11-10 03:44:40 +08:00 · 2023-05-01 18:56:45 -07:00 · 2023-05-01 18:54:35 -07:00 · 2023-01-30 10:56:19 -10:00 · 2022-11-27 18:48:57 +09:00 · 2022-11-03 14:58:50 -07:00
418 changed files with 2798 additions and 5769 deletions
@@ -1,14 +1,25 @@
 ## The problem

-Briefly describe the issue you are experiencing (or the feature you want to see added to Appium). Tell us what you were trying to do and what happened instead. Remember, this is _not_ a place to ask questions. For that, go to http://discuss.appium.io!
+Briefly describe the issue you are experiencing (or the feature you want to see added to Appium). Tell us what you were trying to do and what happened instead. Remember, this is _not_ a place to ask questions. For that consider visiting [Appium Forum](https://discuss.appium.io)!
+
+Before reporting the issue make sure that:
+- The issue is reproducible with the most recent available server and driver versions<sup>*</sup>.
+- There are no other duplicated reports of the same issue.
+- Your description of the issue could be used to reproduce/understand it without any additional details.
+
+<sup>*</sup>Appium1 is at its end of life and is not maintained actively anymore as well as compatible driver versions for it. It is highly recommended to switch to
+[Appium2](https://appiumpro.com/editions/122-installing-appium-20-and-the-driver-and-plugins-cli) to have
+access to the most recent server and driver fixes/updates.

 ## Environment

 * Appium version (or git revision) that exhibits the issue:
 * Last Appium version that did not exhibit the issue (if applicable):
+* Driver version that exhibits the issue (only for Appium2):
+* Last driver version that did not exhibit the issue (if applicable, only for Appium2):
 * Desktop OS/version used to run Appium:
 * Node.js version (unless using Appium.app|exe):
-* Npm or Yarn package manager:
+* Package manager name and version (we only officially support NPM):
 * Mobile platform/version under test:
 * Real device or emulator/simulator:
 * Appium CLI or Appium.app|exe:
@@ -23,7 +34,6 @@ Create a [GIST](https://gist.github.com) which is a paste of your _full_ Appium
 Do _NOT_ paste your full Appium logs here, as it will make this issue very long and hard to read!
 If you are reporting a bug, _always_ include Appium logs!

-
 ## Code To Reproduce Issue [ Good To Have ]

 Please remember that with sample code it's easier to reproduce the bug and it's much faster to fix it.
@@ -1,20 +0,0 @@
-version: 2
-updates:
- package-ecosystem: npm
-  directory: "/sample-code/javascript-webdriverio"
-  schedule:
-    interval: daily
-    time: "11:00"
-  open-pull-requests-limit: 10
- package-ecosystem: npm
-  directory: "/sample-code/javascript-wd"
-  schedule:
-    interval: daily
-    time: "11:00"
-  open-pull-requests-limit: 10
- package-ecosystem: npm
-  directory: "/"
-  schedule:
-    interval: daily
-    time: "11:00"
-  open-pull-requests-limit: 10
@@ -0,0 +1,37 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+name: Node.js CI
+on: [push, pull_request]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [14.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm run clean
+    - run: npm run test
+    - run: npm run e2e-test
+
+  generate_docs:
+    needs: [build]
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js 14.x
+      uses: actions/setup-node@v1
+      with:
+        node-version: 14.x
+    - run: npm run clean
+    - run: npm run generate-docs
@@ -41,8 +41,6 @@ old
 coverage
 docs/mkdocs.yml
 sample-code/javascript-wd/node_modules
-sample-code/php/vendor
-sample-code/php/composer.lock
 sample-code/java/out/
 sample-code/ruby/Gemfile.lock
 sample-code/python/test/results/
@@ -1,30 +0,0 @@
-language: node_js
-node_js: "10"
-os: linux
-addons:
-  apt:
-    sources:
-      - ubuntu-toolchain-r-test
-    packages:
-      - g++-4.8
-      - build-essential
-env:
-  global:
-    - CXX=g++-4.8
-cache:
-  npm: false
-jobs:
-  include:
-    - stage: Tests
-      name: node 10
-      before_script: npm outdated || true
-      script: npm run test && npm run e2e-test
-      after_script: npm run coverage
-    - stage:
-      name: node 12
-      before_script: npm outdated || true
-      script: npm run test && npm run e2e-test
-      node_js: "12"
-    - stage:
-      name: test documentation generation
-      script: npm run generate-docs
@@ -1,3 +1,326 @@
+CHANGES IN VERSION 1.22.3 (FROM 1.22.2)
+===================================
+
+Appium 1.22.3 is a patch release
+
+We're going to move to [Appium 2.x](https://github.com/appium/appium/blob/2.0/docs/en/about-appium/1.x-eol.md).
+Appium 1.x will be receiving minor or patch releases only if XCTest gets breaking updates or major bugs pop up before the EOL.
+
+### iOS(XCUITest)
+
+- Fix failing screenshot issue in Xcode 13.3 and iOS 15.4 combination [WebDriverAgent#573](https://github.com/appium/WebDriverAgent/pull/573)
+    - Please read [the original issue](https://github.com/appium/appium/issues/16604) for more details
+
+CHANGES IN VERSION 1.22.2 (FROM 1.22.1)
+===================================
+
+Appium 1.22.2 is a patch release
+
+We're going to move to [Appium 2.x](https://github.com/appium/appium/blob/2.0/docs/en/about-appium/1.x-eol.md).
+Appium 1.x will be receiving minor or patch releases only if XCTest gets breaking updates or major bugs pop up before the EOL.
+
+### iOS(XCUITest)
+
+- Add `safariTabBarPosition` settings api to help `nativeWebTap` capability/setting consider if the device has the tab bar at the top or at the bottom of Safari window. Please read `safariTabBarPosition` in [Settings API](https://github.com/appium/appium-xcuitest-driver#settings-api) for more details [appium-xcuitest-driver#1361](https://github.com/appium/appium-xcuitest-driver/pull/1361)
+- Do not show the keyboard tutorial in iOS 15 environment for simulators [appium-ios-simulator#315](https://github.com/appium/appium-ios-simulator/pull/315)
+- Fix to pass installation options in [Install App](http://appium.io/docs/en/commands/device/app/install-app/) command [appium-xcuitest-driver#1357](https://github.com/appium/appium-xcuitest-driver/pull/1357)
+- Disable the default XCTest's notification checker to avoid [an issue on iOS 15.2](https://github.com/appium/appium/issues/16025) [WebDriverAgent#540](https://github.com/appium/WebDriverAgent/pull/540)
+- Slightly improve the performance of XML source generation [appium-xcuitest-driver#1351](https://github.com/appium/appium-xcuitest-driver/pull/1351) [WebDriverAgent#544](https://github.com/appium/WebDriverAgent/pull/544)
+
+CHANGES IN VERSION 1.22.1 (FROM 1.22.0)
+===================================
+
+Appium 1.22.1 is a patch release
+
+We're going to move to [Appium 2.x](https://github.com/appium/appium/blob/2.0/docs/en/about-appium/1.x-eol.md).
+Appium 1.x will be receiving minor or patch releases only if XCTest gets breaking updates or major bugs pop up before the EOL.
+
+### General
+* Enforce unzip with JS implementation when `APPIUM_PREFER_SYSTEM_UNZIP` environment variable is given as `0` or `false` [appium-base-driver#537](https://github.com/appium/appium-base-driver/pull/537)
+    * This change may fix [installation error in iOS simulators](https://github.com/appium/appium/issues/16050)
+
+### Android General
+
+* Use bundletool to install .apks packages [appium-adb#578](https://github.com/appium/appium-adb/pull/578)
+* Handle unlock via `locksettings` adb command [appium-adb#577](https://github.com/appium/appium-adb/pull/577)
+* Add a tiny delay after changing IME for Android 12 [appium-adb#581](https://github.com/appium/appium-adb/pull/581)
+
+### Android(UIAutomator2)
+
+* Add capabilities:
+    * `unlockStrategy` to customize the strategy of unlock. Defaults to `locksettings` on Android 8+, where this adb shell command is supported. The previous behavior is `uiautomator`.
+    * `chromeLoggingPrefs` to configure chrome logging preferences mapping [appium-android-driver#710](https://github.com/appium/appium-android-driver/pull/710)
+* Add `mobile:` extensions:
+    * `mobile:unlock` to unlock the device as a mobile command [appium-android-driver#709](https://github.com/appium/appium-android-driver/pull/709)
+* Fix `/appium/device/display_density` endpoint to get the device density on Android 12 by getting it via Android API instead of adb command [appium-uiautomator2-driver#474](https://github.com/appium/appium-uiautomator2-driver/pull/474) [appium-uiautomator2-server#444](https://github.com/appium/appium-uiautomator2-server/pull/444)
+* XPath locators now support [XPath 2.0](https://www.w3.org/TR/xpath20/) specification. XPath 2.0 is backward compatible to v 1.0, which means the most of existing queries should still work as expected. However, more advanced queries might require updates due to the strict type checking. See [issues#16142](https://github.com/appium/appium/issues/16142) [appium-uiautomator2-server#442](https://github.com/appium/appium-uiautomator2-server/pull/442) for more details.
+
+### iOS(XCUITest)
+
+* Decode cookies safely in WebView context [appium-xcuitest-driver#1336](https://github.com/appium/appium-xcuitest-driver/pull/1336)
+* Tune alert monitoring [appium-xcuitest-driver#1340](https://github.com/appium/appium-xcuitest-driver/pull/1340)
+* Add capabilities:
+    * `appInstallStrategy` capability to customize the application installation strategy. `serial`, `parallel` and `ios-deploy` are available. Please read [capabilities](https://github.com/appium/appium-xcuitest-driver#app) for more details. This strategy is available via installation APIs as well.
+* Add `mobile:` extensions:
+    * `mobile:listApps` to get the list of installed applications on the real device under test [appium-xcuitest-driver#1342](https://github.com/appium/appium-xcuitest-driver/pull/1342)
+* Add `NSProcessInfoThermalState` in [mobile: deviceInfo](https://github.com/appium/appium-xcuitest-driver#mobile-deviceinfo) [WebDriverAgent#536](https://github.com/appium/WebDriverAgent/pull/536)
+* Add `nativeWebTapTabBarVisibility` and `nativeWebTapTabBarVisibility` Settings API items to handle _tab bar_ and _smart app banner_ via Settings API [appium-xcuitest-driver#1345](https://github.com/appium/appium-xcuitest-driver/pull/1345) (Thanks @zcmgyu)
+* Fix `useXctestrunFile` capability behavior on Xcode 13 [WebDriverAgent#538](https://github.com/appium/WebDriverAgent/pull/538)
+* Fix caching elements from `execute_script` in WebView context [appium-xcuitest-driver#1350](https://github.com/appium/appium-xcuitest-driver/pull/1350)
+* Fix `<` escape in the XML page source (`"appium:useJSONSource": false`) [appium-xcuitest-driver#1347](https://github.com/appium/appium-xcuitest-driver/pull/1347)
+* Disable the build in notification checker by XCTest to avoid possible UI interuction failure on Xcode 13.2 and iOS 15.2 [WebDriverAgent#540](https://github.com/appium/WebDriverAgent/pull/540)
+
+
+CHANGES IN VERSION 1.22.0 (FROM 1.21.0)
+===================================
+
+Appium 1.22.0 is a minor release
+
+We're going to move to [Appium 2.x](https://github.com/appium/appium/blob/2.0/docs/en/about-appium/1.x-eol.md).
+Appium 1.x will have minor or patch releases only when Appium 1.x gets breaking updates in XCTest or critical bugs before the EOL.
+
+### General
+
+* Add `imageMatchMethod` to be able to customize image mathcing method in [find element by image](http://appium.io/docs/en/advanced-concepts/image-elements/) [appium-base-driver#480](https://github.com/appium/appium-base-driver/pull/480) [appium-support#222](https://github.com/appium/appium-support/pull/222)
+* `appium:enableWebviewDetailsCollection` capability defaults to `true` [appium-android-driver#699](https://github.com/appium/appium-android-driver/pull/699) (Thanks @mwakizaka)
+* Support `satellites` option in `setGeoLocation` command as [geo command on emulators](https://developer.android.com/studio/run/emulator-console) [appium-adb#571](https://github.com/appium/appium-adb/pull/571)
+* Use system unzip to unzip compressed files by default. It fallbacks to JS implementation. [appium-support#226](https://github.com/appium/appium-support/pull/226) [appium-support#227](https://github.com/appium/appium-support/pull/227)
+
+### Android General
+
+* Add `pinWithKeyEvent` option as `unlockType` in [unlock action](https://github.com/appium/appium-android-driver/blob/master/docs/UNLOCK.md) to send the pin code as keyevent [appium-android-driver#691](https://github.com/appium/appium-android-driver/pull/691)
+* Allow to establish a chrome session with its `beta`, `dev` and `canary` [appium-android-driver#699](https://github.com/appium/appium-android-driver/pull/699) (Thanks @mwakizaka)
+* Optimize error handling in certificate validation [appium-adb#572](https://github.com/appium/appium-adb/pull/572)
+
+### Android(UIAutomator2)
+* Add `mobile:` extensions:
+    * `mobile:startActivity` to launch an activity more flexible. Please read [mobile: startActivity](https://github.com/appium/appium-uiautomator2-driver#mobile-startactivity) for more details [appium-android-driver#701](https://github.com/appium/appium-android-driver/pull/701)
+    * `mobile: broadcast` to a send broadcast intent. Please read [mobile: broadcast](https://github.com/appium/appium-uiautomator2-driver#mobile-broadcast) for more details [appium-uiautomator2-driver/471](https://github.com/appium/appium-uiautomator2-driver/pull/471)
+    * `mobile: clearApp` to delete a package data via `adb shell pm clear` [appium-uiautomator2-driver#472](https://github.com/appium/appium-uiautomator2-driver/pull/472)
+* Add active element support [appium-uiautomator2-driver#457](https://github.com/appium/appium-uiautomator2-driver/pull/457) [appium-uiautomator2-server#424](https://github.com/appium/appium-uiautomator2-server/pull/424) (Thanks @vane and @jzaleski)
+
+### Android(Espresso)
+* The default Kotlin plugin version is 1.4.32 [appium-espresso-driver#663](https://github.com/appium/appium-espresso-driver/pull/663)
+* Fix typecast error in build config [appium-espresso-driver#683](https://github.com/appium/appium-espresso-driver/pull/683)
+
+### iOS General
+
+* Xcode 13 and iOS 15 support
+
+### iOS(XCUITest)
+* Add capabilities:
+    * `appium:useNativeCachingStrategy` to reduce a potential stale element error. Please read the capability in [XCUITest capabilities](https://github.com/appium/appium-xcuitest-driver#webdriveragent). Defaults to `true` [appium-xcuitest-driver#1317](https://github.com/appium/appium-xcuitest-driver/pull/1317)
+    * `appium:forceAppLaunch` to launch the application under test forcefully with `appium:bundleId`. Defaults to `true` unless `noReset` capability is set to `true`. [appium-xcuitest-driver#1314](https://github.com/appium/appium-xcuitest-driver/pull/1314)
+    * `appium:forceSimulatorSoftwareKeyboardPresence` to make force enabling simulator keyboard optional for simulator. Please read the section in [capabilities](https://github.com/appium/appium-xcuitest-driver#simulator) for more details. [appium-xcuitest-driver#1327](https://github.com/appium/appium-xcuitest-driver/pull/1327)
+    * `appium:resetLocationService` to reset the location service in the session deletion on real device. [appium-xcuitest-driver#1333](https://github.com/appium/appium-xcuitest-driver/pull/1333)
+* Add `mobile:` extensions:
+    * `mobile:configureLocalization` to change localization settings on the currently booted simulator. Please read [configurelocalization](https://github.com/appium/appium-xcuitest-driver#mobile-configurelocalization) for more details [appium-xcuitest-driver#1300](https://github.com/appium/appium-xcuitest-driver/pull/1300)
+    * `mobile:resetLocationService` to reset the location service. [appium-xcuitest-driver#1333](https://github.com/appium/appium-xcuitest-driver/pull/1333)
+* Add `durationSeconds` argument in `mobile: pressButton` for tvOS
+* Add `getProperty` command to support [Get Element Property](https://www.w3.org/TR/webdriver/#dfn-get-element-property) endpoint. In native context, the command is equal to [Get Element Attribute](https://www.w3.org/TR/webdriver/#get-element-attribute) [appium-xcuitest-driver#1313](https://github.com/appium/appium-xcuitest-driver/pull/1313)
+* Update parsing logic to parse `:wdc:` element id by Safari Web inspector in WebView context [appium-xcuitest-driver#1324](https://github.com/appium/appium-xcuitest-driver/pull/1324) [appium#15230](https://github.com/appium/appium/issues/15230)
+    * Probably the host macOS should have Safari 14.1
+* Improve alert checking logic in Web context [appium-xcuitest-driver#1320](https://github.com/appium/appium-xcuitest-driver/pull/1320)
+* Fix coordinate offset with `absoluteWebLocations` capability in Web context
+[appium-xcuitest-driver#1322](https://github.com/appium/appium-xcuitest-driver/pull/1322)
+* Fix element identification logic for over iOS 13 [WebDriverAgent#523](https://github.com/appium/WebDriverAgent/pull/523) (Thanks @Dan-Maor)
+    * This fix may improve page source results in some environment
+* Fix visibility handling in `mobile:scroll` with `toVisible` argument [WebDriverAgent#528](https://github.com/appium/WebDriverAgent/pull/528) (Thanks @Dan-Maor)
+* Fix `velocity` argument in `mobile:swipe` [appium-xcuitest-driver#1329](https://github.com/appium/appium-xcuitest-driver/pull/1329)
+* Fix: `customSSLCert` capability logic [appium-xcuitest-driver#1334](https://github.com/appium/appium-xcuitest-driver/pull/1334)
+
+### Mac2
+* Add `macos:` extensions:
+    * Add support [swipe guestures](https://github.com/appium/appium-mac2-driver#mobile-swipe) [appium-mac2-driver#85](https://github.com/appium/appium-mac2-driver/pull/85)
+* Add `language` option in `macos: appleScript` to be able to use other languages supported by `osascript` [appium-mac2-driver#89](https://github.com/appium/appium-mac2-driver/pull/89)
+* Add support of touch bar interaction [appium-mac2-driver#87](https://github.com/appium/appium-mac2-driver/pull/87)
+* Fix handling of libxml2 client to prevent memory leaks [appium-mac2-driver#86](https://github.com/appium/appium-mac2-driver/pull/86)
+
+## Windows
+* Add `windows:` extensions:
+    * [`deleteFile`](https://github.com/appium/appium-windows-driver#windows-deletefile) and [`deleteFolder`](https://github.com/appium/appium-windows-driver#windows-deletefolder) [appium-windows-driver#107](https://github.com/appium/appium-windows-driver/pull/107) (Thanks @ggaller)
+* Add [push_file](https://appium.io/docs/en/commands/device/files/push-file/), [pull_file](https://appium.io/docs/en/commands/device/files/pull-file/), [pull_folder](https://appium.io/docs/en/commands/device/files/pull-folder/) [appium-windows-driver#107](https://github.com/appium/appium-windows-driver/pull/107) (Thanks @ggaller)
+* Tune WAD install path lookup [appium-windows-driver#111](https://github.com/appium/appium-windows-driver/pull/111) (Thanks to notice us @blakee1)
+
+### Community/Company based drivers
+#### You.i Engine Driver
+
+The version is `1.2.9`
+
+#### Flutter driver
+
+The version is `0.0.32`
+
+
+CHANGES IN VERSION 1.21.0 (FROM 1.20.2)
+===================================
+
+Appium 1.21.0 is a minor release
+
+### General
+
+* Minimum NodeJS version moved to 12
+* Support multiple image matches for [Finding and Interacting with Image Elements](http://appium.io/docs/en/advanced-concepts/image-elements/) [appium-base-driver#449](https://github.com/appium/appium-base-driver/pull/449) (@khaong)
+
+### Android General
+
+* Disable sending of Google analytics data by instruments [appium-uiautomator2-driver#452](https://github.com/appium/appium-uiautomator2-driver/pull/452), [appium-espresso-driver#666](https://github.com/appium/appium-espresso-driver/pull/666)
+* Improve detection of screen lock status [appium/appium-adb#564](https://github.com/appium/appium-adb/pull/564)
+* Add `speed` optional parameter to mock location [appium-android-driver#681](https://github.com/appium/appium-android-driver/pull/681) (Thanks to @salabogdan)
+* Fix `autoLaunch` to install applications by `app` and `otherApps` capabilities, but does not launch them as same as iOS [appium-uiautomator2-driver#440](https://github.com/appium/appium-uiautomator2-driver/pull/440), [appium-espresso-driver#654](https://github.com/appium/appium-espresso-driver/pull/654), [appium-android-driver#676](https://github.com/appium/appium-android-driver/pull/676)
+* Fix to handle special characters by `mobile:type` [appium-adb#567](https://github.com/appium/appium-adb/pull/567)
+* Fix to switch to Web Views with same package name, but different process names [appium-android-driver#687](https://github.com/appium/appium-android-driver/pull/687)
+* Fix to stop screen recording after a session is closed [appium-android-driver#675](https://github.com/appium/appium-android-driver/pull/675) and each driver
+
+### Android(UIAutomator2)
+
+* Add `mobile:` extensions:
+    * `mobile:doubleClickGesture` for double click guesture [appium-uiautomator2-driver#441](https://github.com/appium/appium-uiautomator2-driver/pull/441), [appium-uiautomator2-server#415](https://github.com/appium/appium-uiautomator2-server/pull/415)
+    * `mobile:installMultipleApks` to install multiple apks via `adb install-multiple` command. Please read [mobile:installMultipleApks](https://github.com/appium/appium-uiautomator2-driver/blob/master/README.md#mobile-installmultipleapks) for more details
+* Fix XPath lookup for queries which have `@*` attribute pattern [appium-uiautomator2-server#417](https://github.com/appium/appium-uiautomator2-server/pull/417)
+
+### Android(Espresso)
+
+* Fix to raise an error in [Reset App](http://appium.io/docs/en/commands/device/app/reset-app/). It must quit the session and create a new one in Espresso driver. [appium-espresso-driver#649](https://github.com/appium/appium-espresso-driver/pull/649)
+* Fix to reset instrumentation state before starting a new instance [appium-espresso-driver#662](https://github.com/appium/appium-espresso-driver/pull/662)
+* Gradle wrapper has been rewritten using Kotlin DSL [appium-espresso-driver#658](https://github.com/appium/appium-espresso-driver/pull/658), [appium-espresso-driver#659](https://github.com/appium/appium-espresso-driver/pull/659) (Thanks to @misa)
+
+### iOS General
+
+* Xcode 12.5 support
+
+### iOS(XCUITest)
+
+* Add capabilities:
+    * `appium:includeDeviceCapsToSessionInfo` to skip adding the screen information in order to improve [Get Session Capabilities](http://appium.io/docs/en/commands/session/get/) API. `mobile:viewportRect` and `mobile:deviceScreenInfo` help to get these information when this capability is `false`. [appium-xcuitest-driver#1278](https://github.com/appium/appium-xcuitest-driver/pull/1278)
+    * `appium:disableAutomaticScreenshots` to handle automatic screenshot by XCTest. Defaults to `true` [appium-xcuitest-driver#1288](https://github.com/appium/appium-xcuitest-driver/pull/1288) (@mrmacete)
+    * `appium:shouldTerminateApp` to handle if Appium terminates the application under test process on the session end. Defaults to `true` [appium-xcuitest-driver#1290](https://github.com/appium/appium-xcuitest-driver/pull/1290), [WebDriverAgent#486/](https://github.com/appium/WebDriverAgent/pull/486/) (Thanks to @mrmacete)
+* Add `mobile:` extensions:
+    * `mobile:viewportRect` returns the screen viewport information which is part of [Get Session Capabilities](http://appium.io/docs/en/commands/session/get/)
+    * `mobile:deviceScreenInfo` returns the screen information which is part of [Get Session Capabilities](http://appium.io/docs/en/commands/session/get/), [WebDriverAgent#483](https://github.com/appium/WebDriverAgent/pull/483)
+    * `mobile:pushNotification` to simulator push notification on simulator by `xcrun simctl push` command. It requires Xcode 11.4+. Please read [mobile:pushNotification](https://github.com/appium/appium-xcuitest-driver#mobile-pushnotification) for mroe details to trigger a push notification. [appium-xcuitest-driver#1286](https://github.com/appium/appium-xcuitest-driver/pull/1286/)
+    * `mobile:expectNotification` to wait for a notification on the device under test. Please read [mobile:expectNotification](https://github.com/appium/appium-xcuitest-driver#mobile-pushnotification) for more information on how to use it. [appium-xcuitest-driver#1287](https://github.com/appium/appium-xcuitest-driver/pull/1287) [WebDriverAgent#480](https://github.com/appium/WebDriverAgent/pull/480)
+    * `mobile:performIoHidEvent` to emulate low-level IO HID device events. Read [mobile:performIoHidEvent](https://github.com/appium/appium-xcuitest-driver#mobile-performiohidevent) for more details. [appium-xcuitest-driver#1291](https://github.com/appium/appium-xcuitest-driver/pull/1291), [WebDriverAgent#494](https://github.com/appium/WebDriverAgent/pull/494)
+* Add css selector support [appium-xcuitest-driver#1274](https://github.com/appium/appium-xcuitest-driver/pull/1274)
+    * `css selector` selector will be converted to `-ios class chain` selector
+* Support [Get Geolocation](https://appium.io/docs/en/commands/session/geolocation/get-geolocation/) API [appium-xcuitest-driver#1266](https://github.com/appium/appium-xcuitest-driver/pull/1266)
+    * _Allow Location Access_ in _Location Services_ for _WebDriverAgent-Runner_ must be set to **Always**
+* Add `accessible` attribute field into the XML page source [WebDriverAgent#493](https://github.com/appium/WebDriverAgent/pull/493) (Thanks to @TheDarkestDay)
+* Improve performance of the keyboard dismissal logic [appium-xcuitest-driver#1267](https://github.com/appium/appium-xcuitest-driver/pull/1267), [WebDriverAgent#458](https://github.com/appium/WebDriverAgent/pull/458)
+* Fix performance degradation of interaction in `nativeWebTap:true` [appium-xcuitest-driver/pull/1265](https://github.com/appium/appium-xcuitest-driver#1265)
+
+### Mac2
+
+* Add capabilities:
+    * `appium:webDriverAgentMacUrl` to allow Appium to connect to a running WebDriverAgentMac instance at this URL [appium-mac2-driver#41](https://github.com/appium/appium-mac2-driver/pull/41)
+* Add a possibility to provide key names for `macos:keys` extension [appium-mac2-driver#60](https://github.com/appium/appium-mac2-driver/pull/60)
+* Add `hittable` attribute field into the XML page source [appium-mac2-driver#65](https://github.com/appium/appium-mac2-driver/pull/65)
+* More fine-grained handling of orphaned xcodebuild processes [appium-mac2-driver#73](https://github.com/appium/appium-mac2-driver/pull/73)
+
+### You.i Engine Driver
+
+The version is `1.2.8`
+
+### Community based drivers
+#### Flutter driver
+
+The version is `0.0.28`
+
+#### New drivers
+
+Add the ability to load `appium-roku-driver`([appium#15227](https://github.com/appium/appium/pull/15227)) and `appium-webos-driver`([appium#15260](https://github.com/appium/appium/pull/15260)) by @cbuelvasc
+
+CHANGES IN VERSION 1.20.2 (FROM 1.20.1)
+===================================
+
+Appium 1.20.2 is a patch release
+
+### Android(UIAutomator2)
+* Fix element caching performance [appium-uiautomator2-server#406](https://github.com/appium/appium-uiautomator2-server/pull/406)
+
+CHANGES IN VERSION 1.20.1 (FROM 1.20.0)
+===================================
+
+Appium 1.20.1 is a patch release
+
+### Android(UIAutomator2)
+* Fix setting the session capabilities [appium-uiautomator2-server#404](https://github.com/appium/appium-uiautomator2-server/pull/404)
+
+CHANGES IN VERSION 1.20.0 (FROM 1.19.1)
+===================================
+
+Appium 1.20.0 is a minor release
+
+### General
+* Does not destory sockets explicitly against a client [appium-base-driver#437](https://github.com/appium/appium-base-driver/pull/437)
+* Connection timeout to each driver respects `--keep-alive-timeout` configuration [appium-base-driver#443](https://github.com/appium/appium-base-driver/pull/443). Default to 10 minutes
+
+### Android General
+* `InvalidContextError` error is thrown if running instrumentation process was dead
+* Fix Android emulator config paths on Windows [appium-adb#558](https://github.com/appium/appium-adb/pull/558)
+
+### Android(UIAutomator2)
+* Appium adds `io.appium.settings`, `io.appium.uiautomator2.server` and `io.appium.uiautomator2.server.test` as the device's Doze whitelist to keep working [appium-uiautomator2-driver#420](https://github.com/appium/appium-uiautomator2-driver/pull/420)
+* Add settings:
+    * `useResourcesForOrientationDetection` to use application resource propertires to determine the current device orientation [appium-uiautomator2-server#389](https://github.com/appium/appium-uiautomator2-server/pull/389)
+
+### Android(Espresso)
+* Appium adds `io.appium.settings` and `io.appium.espressoserver.test` as the device's Doze whitelist to keep working [appium-espresso-driver#627](https://github.com/appium/appium-espresso-driver/pull/627)
+* Add `mobile:` extensions:
+    * `uiautomatorPageSource` returns the page source dump by UIAutomator [appium-espresso-driver#628](https://github.com/appium/appium-espresso-driver/pull/628)
+* Improves XPath lookup performance [appium-espresso-driver#637](https://github.com/appium/appium-espresso-driver/pull/637)
+
+### iOS General
+* Fix updating simulator preference method [appium-ios-simulator#298](https://github.com/appium/appium-ios-simulator/pull/298)
+
+### iOS(XCUITest)
+* Support M1 chip based Mac, Xcode 12.3
+* Snapshots caching logic has been rewritten to improve lookup performance e.g. [WebDriverAgent#404](https://github.com/appium/WebDriverAgent/pull/404), [WebDriverAgent#407](https://github.com/appium/WebDriverAgent/pull/407)
+* Breaking changes
+    * Support over Xcode 10.2, iOS 12.2 (Drop supporting Xcode 10.0 and 10.1)
+    * `accessibility id`, `name` and `id` lookup strategies now find elements by `name`(`wdName`) attributes in page source: [WebDriverAgent#414](https://github.com/appium/WebDriverAgent/pull/414)
+        * Previously, they found elements by `name`(`wdName`) and `value`(`wdValue`)
+        * Please use `predicate` strategy to find `value`(`wdValue`) attribute like [this change](https://github.com/appium/ruby_lib_core/pull/282)
+* Add capabilities:
+    * `resultBundlePath` and `resultBundleVersion` to allow to specify the path to the result bundle of WebDriverAgent xcodebuild [WebDriverAgent#410](https://github.com/appium/WebDriverAgent/pull/410)
+    * `safariIgnoreWebHostnames` to provide a list of hostnames that the Safari automation tools should ignore [appium-xcuitest-driver#1258](https://github.com/appium/appium-xcuitest-driver/pull/
+    1258)
+    * `waitForIdleTimeout` (Please read the below settings section)
+* Add settings: (Please read [Settings API](http://appium.io/docs/en/advanced-concepts/settings/index.html) for more details)
+    * `customSnapshotTimeout` which was renamed from `snapshotTimeout` sets how much time is allowed to resolve a single accessibility snapshot with custom attributes
+    * `waitForIdleTimeout` to customize the time for waiting until the application under test is idling
+        * The value `zero` (not recommended) is equal to `waitForQuiescence` to `false`
+        * **Important**: this is still a workaround, so there is no guarantee it is going to always work. Please consider rather fixing your application source code, because XCTest uses idle intervals to send commands to the accessibility manager. You may get unexpected testing results or application crashes if such intervals don't exist or are too tiny.
+    * `animationCoolOffTimeout` customize the timeout to wait until the application under test has no animation
+* Add a possibility to select elements by indexes [WebDriverAgent#417](https://github.com/appium/WebDriverAgent/pull/417)
+* Fix parsing SSL output from OpenSSL output [appium-xcuitest-driver#1256](https://github.com/appium/appium-xcuitest-driver/pull/1256)
+
+### iOS(Safari)
+
+This driver provides you to communicate with Apple's `safaridriver` binary via Appium.
+It only supports Safari browser automation on macOS and iOS (Simulator/Real Device).
+
+Read https://github.com/appium/appium-safari-driver for more details.
+
+### Mac2
+
+This driver provides you to handle macOS native applications with Apple's `XCTest` framework.
+Read https://github.com/appium/appium-mac2-driver for more details.
+
+### Gecko
+
+This driver provides you to communicate with Firefox browsers on macOS, Windows, Linux and Android with geckodriver binary via Appium.
+Read https://github.com/appium/appium-geckodriver for more details to set the environment up.
+
+CHANGES IN VERSION 1.19.1(FROM 1.19.0)
+===================================
+
+Appium 1.19.1 is a patch release
+
+### iOS(XCUITest)
+
+Patches "missing target for targetId" bug in Safari tests (see [#14867](https://github.com/appium/appium/issues/14867))
+
 CHANGES IN VERSION 1.19.0 (FROM 1.18.3)
 ===================================

@@ -58,7 +381,7 @@ Appium 1.19.0 is a minor release

 ### Flutter

-The version is `0.0.25`
+The version is `0.25`

 ### You.i Engine Driver

@@ -1,12 +1,12 @@
 ## Appium

 [![NPM version](https://badge.fury.io/js/appium.svg)](https://npmjs.org/package/appium)
-[![Dependency Status](https://david-dm.org/appium/appium.svg)](https://david-dm.org/appium/appium)
-[![devDependency Status](https://david-dm.org/appium/appium/dev-status.svg)](https://david-dm.org/appium/appium#info=devDependencies)
-
+[![Node.js CI](https://github.com/appium/appium/actions/workflows/node.js.yml/badge.svg)](https://github.com/appium/appium/actions/workflows/node.js.yml)
 [![Monthly Downloads](https://img.shields.io/npm/dm/appium.svg)](https://npmjs.org/package/appium)
-
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fappium%2Fappium.svg?type=shield)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fappium%2Fappium?ref=badge_shield)
+[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/)
+
+[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://vshymanskyy.github.io/StandWithUkraine/)

 Appium is an open-source, cross-platform test automation tool for native,
 hybrid, and mobile web and desktop apps. We support simulators (iOS), emulators
@@ -19,18 +19,9 @@ started](/docs/en/about-appium/getting-started.md) doc.

 Appium supports app automation across a variety of platforms, like iOS,
 Android, and Windows. Each platform is supported by one or more "drivers",
-which know how to automate that particular platform. Choose a driver below for
-specific information about how that driver works and how to set it up:
+which know how to automate that particular platform.

-* iOS
-    * The [XCUITest Driver](/docs/en/drivers/ios-xcuitest.md)
-    * (DEPRECATED) The [UIAutomation Driver](/docs/en/drivers/ios-uiautomation.md)
-* Android
-    * The [Espresso Driver](/docs/en/drivers/android-espresso.md)
-    * The [UiAutomator2 Driver](/docs/en/drivers/android-uiautomator2.md)
-    * (DEPRECATED) The [UiAutomator Driver](/docs/en/drivers/android-uiautomator.md)
-* The [Windows Driver](/docs/en/drivers/windows.md) (for Windows Desktop apps)
-* The [Mac Driver](/docs/en/drivers/mac.md) (for Mac Desktop apps)
+Please refer to [Appium Platform Support](/docs/en/about-appium/platform-support.md) for more details.

 ### Why Appium?

@@ -67,7 +58,7 @@ Concepts](/docs/en/about-appium/intro.md).
 Your environment needs to be set up for the particular platforms that you want
 to run tests on. Each of the drivers above documents the requirements for their
 particular brand of automation. At a minimum, you will need to be able to run
-Node.js 10+.
+Node.js 12+.

 ### Get Started

@@ -75,13 +66,13 @@ Check out our [Getting Started](/docs/en/about-appium/getting-started.md) guide
 to get going with Appium.

 There is also a sample code that contains [many examples of tests in a variety
-of different languages](https://github.com/appium/appium/tree/master/sample-code)!
+of different languages](https://github.com/appium/appium/tree/1.x/sample-code)!

 ### Documentation

 For prettily-rendered docs, please visit [appium.io](http://appium.io). You can
 always find the full list of Appium doc pages at [Appium's GitHub
-Repo](https://github.com/appium/appium/tree/master/docs/en/) as well.
+Repo](https://github.com/appium/appium/tree/1.x/docs/en/) as well.

 [update-appium-io.yml](https://github.com/appium/appium/blob/master/ci-jobs/update-appium-io.yml) creates a PR
 by [CI job](https://dev.azure.com/AppiumCI/Appium%20CI/_build?definitionId=37).
@@ -1,8 +1,8 @@
 # parameters: # No params yet, but may add later
 jobs:
  - job: generate_docs
-    pool: 
-      vmImage: "macOS 10.14"
+    pool:
+      vmImage: "macOS-latest"
    variables:
      CC: gcc
      CXX: g++
@@ -15,7 +15,11 @@ jobs:
        npm install
        brew install hub
        hub --version
+        git config --global user.name "Appium Maintainers"
+        git config --global user.email "maintainers@appium.io"
        git remote add triager https://triager:$GITHUB_TOKEN@github.com/appium/appium
+        # Change the main branch
+        git checkout 1.x
        git checkout -b generate-docs-$BUILD_SOURCEVERSION
        git status
      displayName: Checkout Generate Docs Branch
@@ -33,7 +37,7 @@ jobs:
        if [[ -n $(git status -s) ]]; then
          git commit -a -n -m 'Update generated docs [ci skip]'
          git push triager generate-docs-$BUILD_SOURCEVERSION
-          hub pull-request -b "appium:master" -h "appium:generate-docs-$BUILD_SOURCEVERSION" -m "docs: Update auto-generated docs"
+          hub pull-request -b "appium:1.x" -h "appium:generate-docs-$BUILD_SOURCEVERSION" -m "docs: Update auto-generated docs for Appium 1"
        fi
      displayName: Generate Docs and Make PR
      env:
@@ -2,7 +2,7 @@
 jobs:
  - job: bundle_and_upload_appium_zip
    pool:
-      vmImage: 'macOS 10.14'
+      vmImage: 'macOS-latest'
    variables:
      CC: gcc
      CXX: g++
@@ -14,13 +14,6 @@ jobs:
        versionSpec: '12.x'
    - script: npm ci || npm install # "npm ci" if shrinkwrap is present
      displayName: Install NPM Dependencies
-    - script: |
-        pushd node_modules/appium-webdriveragent
-        carthage bootstrap --no-use-binaries
-        cp Cartfile.resolved Carthage
-        mkdir -p ./Resources/WebDriverAgent.bundle
-        popd
-      displayName: Fully build XCUITestDriver
    - script: npm run build
      displayName: npm run build
    - script: npm prune --production
@@ -2,14 +2,14 @@
 jobs:
  - job: update_appium_io
    pool:
-      vmImage: 'Ubuntu-18.04'
+      vmImage: 'Ubuntu-20.04'
    variables:
      CC: gcc
      CXX: g++
    steps:
    - task: NodeTool@0
      inputs:
-        versionSpec: '10.x'
+        versionSpec: '14.x'
    - script: |
        pip install mkdocs==0.16.3
        git config --global user.email "maintainers@appium.io"
@@ -28,4 +28,4 @@ jobs:
        popd
      displayName: Make branch with Updated Docs and make PR
      env:
-        GITHUB_TOKEN: $(GITHUB_TOKEN)
+        GITHUB_TOKEN: $(GITHUB_TOKEN)
@@ -32,9 +32,6 @@ example_usage:
      context = current_context
  ruby_core:
      context = @driver.current_context
-  php:
-    |
-      $context = $driver->context();
  csharp:
    |
       string Context = driver.Context;
@@ -46,7 +43,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/doc/api.md"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#current_context-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#current_context-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -66,7 +62,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -8,10 +8,10 @@ description:
    For information on the format of the context names, see the [get context
    documentation](/docs/en/commands/context/get-context.md).

-    [mobile command](/docs/en/commands/mobile-command.md) 
-    `mobile: getContexts` is available on iOS (XCUITest) and Android 
-    (UIAutomator2 and Espresso) to get more detailed contexts. 
-    
+    [mobile command](/docs/en/commands/mobile-command.md)
+    `mobile: getContexts` is available on iOS (XCUITest) and Android
+    (UIAutomator2 and Espresso) to get more detailed contexts.
+
    For information on contexts, see Appium's [hybrid automation docs](/docs/en/writing-running-appium/web/hybrid.md).

 example_usage:
@@ -33,9 +33,6 @@ example_usage:
  ruby_core:
    |
      context = @driver.available_contexts
-  php:
-    |
-      $contexts = $driver->contexts();
  csharp:
    |
       List<string> AllContexts = new List<string>();
@@ -51,7 +48,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/doc/api.md"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#available_contexts-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#available_contexts-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -71,7 +67,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -50,12 +50,6 @@ example_usage:
      @driver.set_context(webview)
      # ...
      @driver.set_context('NATIVE_APP')
-  php:
-    |
-      $contexts = $driver->contexts();
-      $driver->context($contexts[1]);
-      // ...
-      $driver->context('NATIVE_APP');
  csharp:
    |
    // Switch to specific webview
@@ -75,7 +69,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/doc/api.md"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#set_context-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#set_context-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -95,7 +88,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.current_activity
-  php:
-    |
-      $activity = $driver->currentActivity();
  csharp:
    |
      string activity = driver.CurrentActivity;
@@ -35,7 +32,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2519"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#current_activity-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#current_activity-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs"

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.current_package
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      string package = driver.CurrentPackage;
@@ -35,7 +32,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#getcurrentpackage"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#current_package-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#current_package-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs"

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: false
@@ -24,10 +24,6 @@ example_usage:
  ruby_core:
    |
      @driver.start_activity app_package: "com.example", app_activity: "ActivityName"
-  php:
-    |
-      $driver->startActivity(array('appPackage' => 'com.example',
-                                   'appActivity' => 'ActivityName'));
  csharp:
    |
      driver.StartActivity("com.example", "ActivityName");
@@ -39,7 +35,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2948"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#start_activity-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#start_activity-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs"

 # Driver support by platform
@@ -59,7 +54,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -30,9 +30,6 @@ example_usage:
    |
      @driver.activate_app('com.apple.Preferences')
      @driver.activate_app('io.appium.android.apis')
-  php:
-    |
-      // Supports only `mobile: queryAppState` for iOS, XCUITest
  csharp:
    |
      driver.activateApp('com.apple.Preferences');
@@ -45,7 +42,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js" # TODO wd documentation link
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#activate_app-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#activate_app-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -65,7 +61,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -30,9 +30,6 @@ example_usage:
    |
      @driver.app_state('com.apple.Preferences')
      @driver.query_app_state('io.appium.android.apis') # `query_` prefix is also available
-  php:
-    |
-      // Supports only `mobile: queryAppState` for iOS, XCUITest
  csharp:
    |
      // Supports only `mobile: queryAppState` for iOS, XCUITest
@@ -44,7 +41,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js" # TODO wd documentation link
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Base/Driver#app_state-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Base/Driver#app_state-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -64,7 +60,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -73,7 +68,7 @@ client_support:
 # Information about the HTTP endpoints
 endpoint:
  url: /session/:session_id/appium/device/app_state
-  method: GET
+  method: POST
  url_parameters:
    - name: session_id
      description: ID of the session to route the command to
@@ -42,9 +42,6 @@ example_usage:
  ruby_core:
    |
      @driver.background_app(10)
-  php:
-    |
-      $driver->backgroundApp(10);
  csharp:
    |
      driver.BackgroundApp(10)
@@ -56,7 +53,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2841"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#background_app-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#background_app-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -76,7 +72,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -20,9 +20,6 @@ example_usage:
  ruby_core:
    |
      @driver.close_app
-  php:
-    |
-      $driver->closeApp();
  csharp:
    |
      driver.CloseApp();
@@ -34,7 +31,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2798"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#close_app-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#close_app-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -54,7 +50,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -20,9 +20,6 @@ example_usage:
  ruby_core:
    |
      @driver.end_coverage("Intent", "/path")
-  php:
-    |
-      $driver->endTestCoverage('Intent', '/path');
  csharp:
    |
      driver.EndTestCoverage("Intent", "/path");
@@ -34,7 +31,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#endcoverage"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#end_coverage-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#end_coverage-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs"

 # Driver support by platform
@@ -54,7 +50,6 @@ client_support:
  java: true
  python: true
  ruby: false
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -20,9 +20,6 @@ example_usage:
  ruby_core:
    |
      @driver.app_strings("en")
-  php:
-    |
-      $strings = $driver->appStrings();
  csharp:
    |
      Dictionary<string, object> appStrings = driver.GetAppStringDictionary("end", "/path/to/file");
@@ -34,7 +31,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2916"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#app_strings-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#app_strings-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -54,7 +50,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -25,9 +25,6 @@ example_usage:
  ruby_core:
    |
      @driver.install_app('/Users/johndoe/path/to/app.apk')
-  php:
-    |
-      $driver->installApp('/Users/johndoe/path/to/app.apk');
  csharp:
    |
      driver.InstallApp("/Users/johndoe/path/to/app.apk")
@@ -39,7 +36,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2540"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#install_app-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#install_app-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -59,7 +55,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -25,9 +25,6 @@ example_usage:
  ruby_core:
    |
      @driver.app_installed?('com.example.AppName')
-  php:
-    |
-      $driver->isAppInstalled('com.example.AppName')
  csharp:
    |
      driver.IsAppInstalled("com.example.AppName");
@@ -39,7 +36,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2586"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#app_installed%3F-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#app_installed%3F-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -59,7 +55,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -28,9 +28,6 @@ example_usage:
  ruby_core:
    |
      @driver.launch_app
-  php:
-    |
-      $driver->launchApp();
  csharp:
    |
      driver.LaunchApp();
@@ -42,7 +39,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2798"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#launch_app-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#launch_app-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -62,7 +58,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -26,9 +26,6 @@ example_usage:
  ruby_core:
    |
      @driver.remove_app('com.example.AppName')
-  php:
-    |
-      $driver->removeApp('com.example.AppName');
  csharp:
    |
      driver.RemoveApp("com.example.AppName");
@@ -40,7 +37,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2563"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#remove_app-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#remove_app-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -60,7 +56,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -20,9 +20,6 @@ example_usage:
  ruby_core:
    |
      @driver.reset
-  php:
-    |
-      $driver->reset();
  csharp:
    |
      driver.ResetApp();
@@ -34,7 +31,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2827"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#reset-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#reset-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -54,7 +50,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -30,9 +30,6 @@ example_usage:
    |
      @driver.terminate_app('com.apple.Preferences')
      @driver.terminate_app('io.appium.android.apis')
-  php:
-    |
-      // Supports only `mobile: queryAppState` for iOS, XCUITest
  csharp:
    |
      // Supports only `mobile: queryAppState` for iOS, XCUITest
@@ -44,7 +41,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js" # TODO wd documentation link
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Base/Driver#terminate_app-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Base/Driver#terminate_app-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -64,7 +60,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -28,9 +28,6 @@ example_usage:
  ruby_core:
    |
      @driver.finger_print 1
-  php:
-    |
-      // PHP Code here
  csharp:
    |
      // CSharp Code here
@@ -42,7 +39,6 @@ client_docs:
  javascript_wd: "https://github.com/appium/appium-android-driver/blob/d16c7161d92ab6f6c9cec3f22218219ac3659716/lib/commands/actions.js#L260"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device#finger_print-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device#finger_print-instance_method"
-  php:
  csharp:

 # Driver support by platform
@@ -62,7 +58,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -6,8 +6,14 @@ description:
    Get the content of the system clipboard


-    (For iOS real devices)
+    (For iOS 13+ real devices)
    Apple security preferences require the WebDriverAgentRunner application to be in [foreground](https://github.com/appium/WebDriverAgent/issues/330) in order to be able to receive the system clipboard content. Otherwise an empty string is always returned. Consider using [Activate App](/docs/en/commands/device/app/activate-app.md) and [Background App](/docs/en/commands/device/app/background-app.md) to change the foreground application.
+    Activate App command cannot launch the WebDriverAgent properly on some environments. It depends on XCTest framework by Apple. Then, you should launch the WebDriverAgent using its Springboard's application icon. Follow the example below.
+
+    1. Open Springboard, `@driver.activate_app 'com.apple.springboard'`.
+    2. Find the WDA icon with `@driver.find_element :accessibility_id, 'WebDriverAgentRunner-Runner'` (It should be visible on the screen) and click it.
+    3. Call the get clipboard API.
+    4. Open the application under test with the [Activate App](/docs/en/commands/device/app/activate-app.md).

 example_usage:
  java:
@@ -30,9 +36,6 @@ example_usage:
  ruby_core:
    |
      @driver.get_clipboard
-  php:
-    |
-      // PHP Code here
  csharp:
    |
      // CSharp Code here
@@ -48,7 +51,6 @@ client_docs:
  ruby_core:
    - android: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#get_clipboard-instance_method"
    - ios: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Ios/Device#get_clipboard-instance_method"
-  php: "https://github.com/appium/php-client/releases/latest"
  csharp: "https://github.com/appium/appium" # TODO

 # Driver support by platform
@@ -68,7 +70,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -5,6 +5,15 @@ description:
  >
    Set the content of the system clipboard

+    (For iOS 15+ real devices)
+    Apple security preferences require the WebDriverAgentRunner application to be in [foreground](https://github.com/appium/appium/issues/16526) in order to set the system clipboard content. Consider using [Activate App](/docs/en/commands/device/app/activate-app.md) and [Background App](/docs/en/commands/device/app/background-app.md) to change the foreground application.
+    Activate App command cannot launch the WebDriverAgent properly on some environments. It depends on XCTest framework by Apple. Then, you should launch the WebDriverAgent using its Springboard's application icon. Follow the example below.
+
+    1. Open Springboard, `@driver.activate_app 'com.apple.springboard'`.
+    2. Find the WDA icon with `@driver.find_element :accessibility_id, 'WebDriverAgentRunner-Runner'` (It should be visible on the screen) and click it.
+    3. Call the get clipboard API.
+    4. Open the application under test with the [Activate App](/docs/en/commands/device/app/activate-app.md).
+
 example_usage:
  java:
    |
@@ -27,9 +36,6 @@ example_usage:
  ruby_core:
    |
      @driver.set_clipboard content: 'happy testing'
-  php:
-    |
-      // PHP Code here
  csharp:
    |
      // CSharp Code here
@@ -45,7 +51,6 @@ client_docs:
  ruby_core:
    - ios: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Ios/Device#set_clipboard-instance_method"
    - android: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#set_clipboard-instance_method"
-  php: "https://github.com/appium/php-client/releases/latest"
  csharp: "https://github.com/appium/appium" # TODO

 # Driver support by platform
@@ -65,7 +70,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -48,7 +48,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: false
  javascript_wdio: false
@@ -48,7 +48,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: false
  javascript_wdio: false
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.pull_file('/data/local/tmp/file.txt')
-  php:
-    |
-      $data = $driver->pullFile('data/local/tmp/file.txt');
  csharp:
    |
      byte[] fileBase64 = driver.PullFile("/path/to/device/foo.bar");
@@ -35,7 +32,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2665"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#pull_file-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#pull_file-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.pull_folder('/data/local/tmp/file.txt')
-  php:
-    |
-      $folderBase64 = $driver->pullFolder($path);
  csharp:
    |
      byte[] folder = driver.PullFolder("/path/to/device");
@@ -35,7 +32,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2688"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#pull_folder-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#pull_folder-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -5,7 +5,7 @@ short_description: Place a file onto the device in a particular place
 example_usage:
  java:
    |
-      driver.pushFile("/path/to/device/foo.bar", new File("/Users/johndoe/files/foo.bar"));
+      driver.pushFile("/data/local/tmp/foo.bar", new File("/Users/johndoe/files/foo.bar"));
  python:
    |
      dest_path = '/data/local/tmp/test_push_file.txt'
@@ -13,23 +13,20 @@ example_usage:
      self.driver.push_file(dest_path, base64.b64encode(data).decode('utf-8'))
  javascript_wd:
    |
-      await driver.pushFileToDevice('/path/to/device/foo.bar', 'QXJlIHlvdXIgYmVlcnMgb2theT8=');
+      await driver.pushFileToDevice('/data/local/tmp/foo.bar', 'QXJlIHlvdXIgYmVlcnMgb2theT8=');
  javascript_wdio:
    |
-      let data = new Buffer("Hello World").toString('base64');
+      let data = Buffer.from("Hello World").toString('base64');
      driver.pushFile('/data/local/tmp/file.txt', data);
  ruby:
    |
-      push_file('/path/to/device/foo.bar', File.read('path/to/file.png'))
+      push_file('/data/local/tmp/foo.bar', File.read('path/to/file.png'))
  ruby_core:
    |
-      @driver.push_file('/path/to/device/foo.bar', File.read('path/to/file.png'))
-  php:
-    |
-      $driver->pushFile('/path/to/device/foo.bar', 'QXJlIHlvdXIgYmVlcnMgb2theT8=');
+      @driver.push_file('/data/local/tmp/foo.bar', File.read('path/to/file.png'))
  csharp:
    |
-      driver.PushFile("/path/to/device/foo.bar", new FileInfo("/Users/johndoe/files/foo.bar"))
+      driver.PushFile("/data/local/tmp/foo.bar", new FileInfo("/Users/johndoe/files/foo.bar"))

 client_docs:
  java: "https://appium.github.io/java-client/io/appium/java_client/android/PushesFiles.html#pushFile-java.lang.String-java.io.File-"
@@ -38,7 +35,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2640"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#push_file-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#push_file-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -58,7 +54,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -22,9 +22,6 @@ example_usage:
  ruby_core:
    |
      @driver.device_locked?
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      bool isLocked = driver.IsLocked(); // Supported by IOSDriver & AndroidDriver
@@ -36,7 +33,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2407"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#device_locked%3F-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#device_locked%3F-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs"

 # Driver support by platform
@@ -56,7 +52,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -25,9 +25,6 @@ example_usage:
    |
      @driver.lock
      @driver.lock(5) # lock 5 seconds
-  php:
-    |
-      $driver->lock(5);
  csharp:
    |
      driver.Lock(); // Supported by IOSDriver & AndroidDriver
@@ -39,7 +36,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2363"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#lock-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#lock-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs"

 # Driver support by platform
@@ -59,7 +55,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -12,9 +12,6 @@ example_usage:
  javascript_wdio:
    |
      driver.rotateDevice(100, 100);
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      driver.Rotate(new Dictionary<string, int> { { "x", 114 }, { "y", 198 }, { "duration", 5 }, { "radius", 3 }, { "rotation", 220 }, { "touchCount", 2 } });
@@ -23,7 +20,6 @@ client_docs:
  java: "https://appium.github.io/java-client/io/appium/java_client/AppiumDriver.html#rotate-org.openqa.selenium.DeviceRotation-"
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#rotatedevice"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2470"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -43,7 +39,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -22,9 +22,6 @@ example_usage:
  ruby_core:
    |
      @driver.shake
-  php:
-    |
-      $driver->shake();
  csharp:
    |
      driver.ShakeDevice();
@@ -36,7 +33,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2342"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#shake-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#shake-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/iOS/IOSDriver.cs"

 # Driver support by platform
@@ -56,7 +52,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -25,9 +25,6 @@ example_usage:
  ruby_core:
    |
      @driver.unlock
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      driver.Unlock(); // Supported by IOSDriver & AndroidDriver
@@ -39,7 +36,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2386"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#unlock-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#unlock-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Android/AndroidDriver.cs"

 # Driver support by platform
@@ -59,7 +55,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -21,12 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.hide_keyboard
-  php:
-    |
-      $driver->hideKeyboard();
-      $driver->hideKeyboard(array(
-            'keyName' => 'Done'
-      ));
  csharp:
    |
      driver.HideKeyboard();
@@ -38,7 +32,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2723"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#hide_keyboard-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#hide_keyboard-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -58,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -47,7 +47,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: false
@@ -23,9 +23,6 @@ example_usage:
  ruby_core:
    |
      @driver.long_press_keycode(10)
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      driver.LongPressKeyCode(WindowsKeyCode.Back);
@@ -37,7 +34,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2478"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#long_press_keycode-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#long_press_keycode-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Windows/WindowsDriver.cs"

 # Driver support by platform
@@ -57,7 +53,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -23,9 +23,6 @@ example_usage:
  ruby_core:
    |
      @driver.press_keycode(10)
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      driver.PressKeyCode(WindowsKeyCode.Windows);
@@ -37,7 +34,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2457"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#press_keycode-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#press_keycode-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/Windows/WindowsDriver.cs"

 # Driver support by platform
@@ -57,7 +53,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.gsm_call(phone_number: '5551234567', action: :call)
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -35,7 +32,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#gsmcall"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#gsm_call-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#gsm_call-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.gsm_signal :good
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -35,7 +32,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#gsmsignal"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#gsm_signal-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#gsm_signal-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.gsm_voice :home
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -35,7 +32,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#gsmvoice"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#gsm_voice-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#gsm_voice-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -47,7 +47,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.send_sms(phone_number: '555-123-4567', message: 'Hey lol')
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -35,7 +32,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#sendsms"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#send_sms-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Android/Device/Emulator#send_sms-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -18,9 +18,6 @@ example_usage:
  ruby_core:
    |
      @driver.toggle_flight_mode
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -31,7 +28,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2712"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#toggle_flight_mode-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#toggle_flight_mode-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -51,7 +47,6 @@ client_support:
  java: true
  python: false
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -24,9 +24,6 @@ example_usage:
  ruby_core:
    |
      @driver.toggle_data
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -37,7 +34,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2771"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Device#toggle_data-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Device#toggle_data-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -57,7 +53,6 @@ client_support:
  java: true
  python: false
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.toggle_location_services
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -35,7 +32,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2758"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Device#toggle_location_services-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Device#toggle_location_services-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -29,9 +29,6 @@ example_usage:
  ruby_core:
    |
      @driver.toggle_wifi
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -43,7 +40,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2738"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Device#toggle_wifi-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/master/Appium/Core/Device#toggle_wifi-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -63,7 +59,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -22,9 +22,6 @@ example_usage:
  ruby_core:
    |
      @driver.get_performance_data package_name: 'io.appium.android.apis', data_type: 'cpuinfo', data_read_timeout: 10
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      // Not supported
@@ -36,7 +33,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#getperformancedata"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#get_performance_data-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#get_performance_data-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -56,7 +52,6 @@ client_support:
  java: true
  python: false
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.get_performance_data_types
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      // Not supported
@@ -35,7 +32,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#getperformancedatatypes"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#get_performance_data_types-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#get_performance_data_types-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: false
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -7,9 +7,6 @@ example_usage:
    |
      driver.startRecordingScreen();
      driver.startRecordingScreen(new BaseStartScreenRecordingOptions(....));
-  javascript_wd:
-    |
-      await driver.startRecordingScreen();
  javascript_wdio:
    |
      driver.startRecordingScreen();
@@ -26,9 +23,6 @@ example_usage:
  python:
    |
      self.driver.start_recording_screen()
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      driver.StartRecordingScreen(
@@ -40,7 +34,6 @@ example_usage:
 client_docs:
  java: "https://static.javadoc.io/io.appium/java-client/6.1.0/io/appium/java_client/screenrecording/CanRecordScreen.html#startRecordingScreen-T-"
  python: "https://appium.github.io/python-client-sphinx/webdriver.extensions.html#webdriver.extensions.screen_record.ScreenRecord.start_recording_screen"
-  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L3412"
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#startrecordingscreen"
  ruby:
    - android: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#start_recording_screen-instance_method"
@@ -48,7 +41,6 @@ client_docs:
  ruby_core:
    - android: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#start_recording_screen-instance_method"
      ios: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Ios/Xcuitest/Device#start_recording_screen-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -68,7 +60,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -115,7 +106,7 @@ endpoint:
    - name: options.videoType
      type: string
      description: (iOS Only) The format of the screen capture to be recorded.
-                   Available formats are the output of `ffmpeg -codecs` such as `libx264` and `mpeg4`. Defaults to `mpeg4`.
+                   Available formats are the output of `ffmpeg -codecs` such as `libx264` and `mpeg4`. Defaults to `mjpeg`.
    - name: options.videoQuality
      type: string
      description: (iOS Only) The video encoding quality (low, medium, high, photo - defaults to medium).
@@ -24,9 +24,6 @@ example_usage:
  python:
    |
      self.driver.stop_recording_screen()
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      driver.StopRecordingScreen();
@@ -38,7 +35,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#stoprecordingscreen"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#stop_recording_screen-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#stop_recording_screen-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumDriver.cs"

 # Driver support by platform
@@ -58,7 +54,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: true
  javascript_wdio: true
@@ -7,6 +7,8 @@ description:
    To enable this feature, the `allowTouchIdEnroll` desired capability must be set to true. When `allowTouchIdEnroll` is set to true
    the Simulator will be enrolled by default, and the 'Toggle Touch ID Enrollment' changes the enrollment state.

+    Another way to enable touch id is by using `mobile: enrollBiometric`. More info [here](https://github.com/appium/appium-xcuitest-driver#mobile-enrollbiometric).
+
    This call will only work if the Appium process or its parent application (e.g., Terminal.app or Appium.app) has access to Mac OS accessibility in System Preferences > Security & Privacy > Privacy > Accessibility list

 example_usage:
@@ -28,9 +30,6 @@ example_usage:
  ruby_core:
    |
      @driver.toggle_touch_id_enrollment
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      // TODO C# sample
@@ -42,7 +41,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L3150"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Ios/Device#toggle_touch_id_enrollment-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Ios/Device#toggle_touch_id_enrollment-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -62,7 +60,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -40,9 +40,6 @@ example_usage:
    |
      @driver.touch_id(false) # Simulates a failed touch
      @driver.touch_id(true) # Simulates a passing touch
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      driver.PerformTouchID(false); // Simulates a failed touch
@@ -55,8 +52,7 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L3133"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Ios/Device#touch_id-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Ios/Device#touch_id-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
-  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/iOS/IOSDriver.cs" 
+  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/iOS/IOSDriver.cs"

 # Driver support by platform
 driver_support:
@@ -75,7 +71,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -43,7 +43,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: false
  javascript_wdio: true
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.open_notifications();
-  php:
-    |
-      $driver->openNotifications();
  csharp:
    |
      // TODO
@@ -35,7 +32,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L3004"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#open_notifications-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#open_notifications-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -55,7 +51,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -18,9 +18,6 @@ example_usage:
  ruby_core:
    |
      @driver.get_system_bars
-  php:
-    |
-      // TODO
  csharp:
    |
      // TODO
@@ -31,7 +28,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#getsystembars"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#get_system_bars-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#get_system_bars-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -51,7 +47,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: false
  csharp: false
  javascript_wd: false
  javascript_wdio: true
@@ -24,9 +24,6 @@ example_usage:
  ruby_core:
    |
      @driver.device_time
-  php:
-    |
-      $time = $driver->getDeviceTime();
  csharp:
    |
      string result = driver.DeviceTime;
@@ -38,7 +35,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L3119"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#device_time-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#device_time-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -58,7 +54,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -8,7 +8,7 @@ example_usage:
      element.clear();
  python:
    |
-      self.driver.find_element_by_accessibility_id('SomeAccessibilityID').clear()
+      self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="SomeAccessibilityID").clear()
  javascript_wd:
    |
      let element = await driver.elementByAccessibilityId("SomeAccessibilityID");
@@ -22,9 +22,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, "SomeAccessibilityID").clear
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -38,7 +35,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1780"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:clear"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:clear"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Remote/RemoteWebElement.cs"

 # Driver support by platform
@@ -58,7 +54,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -13,8 +13,8 @@ example_usage:
      el.click();
  python:
    |
-      el = self.driver.find_element_by_accessibility_id('SomeId')
-      el.click();
+      el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='SomeId')
+      el.click()
  javascript_wd:
    |
      let element = await driver.elementByAccessibilityId('id', 'SomeId');
@@ -29,9 +29,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, 'SomeId').click
-  php:
-    |
-      $driver->byAccessibilityId('SomeId')->click();
  csharp:
    |
      MobileElement el = driver.FindElement(MobileByAccessibilityID("Some ID");
@@ -48,7 +45,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1672"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#click-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#click-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -68,7 +64,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -14,7 +14,7 @@ example_usage:
      element.sendKeys("Hello world!");
  python:
    |
-      self.driver.find_element_by_accessibility_id('SomeAccessibilityID').send_keys('Hello world!')
+      self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="SomeAccessibilityID").send_keys('Hello world!')
  javascript_wd:
    |
      let element = await driver.elementByAccessibilityId("SomeAccessibilityID");
@@ -28,10 +28,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, "SomeAccessibilityID").send_keys("Hello World!")
-  php:
-    |
-      $el = $this->byAccessibilityId('SomeAccessibilityID');
-      $el->setText('Hello world!');
  csharp:
    |
      MobileElement el = driver.FindElement(MobileByAccessibilityID("Some ID");
@@ -48,7 +44,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1700"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#send_keys-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#send_keys-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -68,7 +63,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -23,10 +23,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, 'SomeAccessibilityID').attribute("content-desc")
-  php:
-    |
-      $el = $this->byAccessibilityId('SomeAccessibilityID');
-      $name = $el->attribute('name');
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -40,7 +36,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1350"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FElement:attribute"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FElement:attribute"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm if all the drivers support this
@@ -60,7 +55,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -68,7 +62,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/attribute/:name
+  url: /session/:session_id/element/:element_id/attribute/:name
  method: 'GET'
  url_parameters:
    - name: session_id
@@ -29,9 +29,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:id, 'SomeId').css_value
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var element = driver.FindElementById("SomeId");
@@ -44,7 +41,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1447"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:css_value"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:css_value"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm if all the drivers support this
@@ -64,7 +60,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -72,7 +67,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/css/:property_name
+  url: /session/:session_id/element/:element_id/css/:property_name
  method: GET
  url_parameters:
    - name: session_id
@@ -23,10 +23,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, "SomeAccessibilityID").displayed?
-  php:
-    |
-      $el = $this->byAccessibilityId('SomeAccessibilityID');
-      $isDisplayed = $el->displayed();
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -39,7 +35,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1370"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FElement:displayed%3F"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FElement:displayed%3F"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm support for these per platform
@@ -59,7 +54,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -22,9 +22,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, "SomeAccessibilityID").enabled?
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -37,7 +34,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1386"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#enabled%3F-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#enabled%3F-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm support for these per platform
@@ -57,7 +53,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -37,7 +37,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -45,7 +44,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/location_in_view
+  url: /session/:session_id/element/:element_id/location_in_view
  method: GET
  url_parameters:
    - name: session_id
@@ -25,10 +25,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, 'SomeAccessibilityID').location
-  php:
-    |
-      $el = $this->byAccessibilityId('SomeAccessibilityID');
-      $location = $el->location();
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -41,7 +37,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2175"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:location"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:location"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm if all the drivers support this
@@ -61,7 +56,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -69,7 +63,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/location
+  url: /session/:session_id/element/:element_id/location
  method: GET
  url_parameters:
    - name: session_id
@@ -23,9 +23,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, 'SomeAccessibilityID').tag_name
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -38,7 +35,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1336"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#tag_name-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#tag_name-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm if all the drivers support this
@@ -58,7 +54,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -66,7 +61,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/name
+  url: /session/:session_id/element/:element_id/name
  method: 'GET'
  url_parameters:
    - name: session_id
@@ -18,9 +18,6 @@ example_usage:
  ruby:
    |
      // TODO Ruby sample
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      // TODO C# sample
@@ -31,7 +28,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/mjsonwp.html#getpageindex"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1336"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#tag_name-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # TODO: Confirm if all the drivers support this
@@ -51,7 +47,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -27,9 +27,6 @@ example_usage:
    |
      element = @driver.find_element :accessibility_id, "SomeAccessibilityID"
      element.rect
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -40,7 +37,6 @@ client_docs:
  javascript_wdio: "https://webdriver.io/docs/api/webdriver.html#getelementrect"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#rect-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#rect-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm if all the drivers support this
@@ -60,7 +56,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -68,7 +63,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/rect
+  url: /session/:session_id/element/:element_id/rect
  method: GET
  url_parameters:
    - name: session_id
@@ -27,9 +27,6 @@ example_usage:
    |
      element = @driver.find_element :accessibility_id, "SomeAccessibilityID"
      @driver.replace_value element, 'some'
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      // TODO C# sample
@@ -41,7 +38,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1832" # TODO JAvaScript documentation link
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#replace_value-instance_method"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device#replace_value-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -61,7 +57,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -22,9 +22,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, "SomeAccessibilityID").selected?
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -37,7 +34,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1402"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#selected%3F-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#selected%3F-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm support for these per platform
@@ -57,7 +53,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -25,10 +25,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, 'SomeAccessibilityID').size
-  php:
-    |
-      $el = $this->byAccessibilityId('SomeAccessibilityID');
-      $size = $el->size();
  csharp:
    |
      var element = driver.FindElementByAccessibilityId("SomeAccessibilityID");
@@ -41,7 +37,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L2203"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:size"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element:size"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # TODO: Confirm if all the drivers support this
@@ -61,7 +56,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -69,7 +63,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/size
+  url: /session/:session_id/element/:element_id/size
  method: GET
  url_parameters:
    - name: session_id
@@ -29,10 +29,6 @@ example_usage:
    |
      element = @driver.find_element :accessibility_id, "SomeAccessibilityID"
      element.text
-  php:
-    |
-      $el = $this->byAccessibilityId('SomeAccessibilityID');
-      $text = $el->text();
  csharp:
    |
      var element = driver.FindElementByClassName("SomeClassName");
@@ -45,7 +41,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1832"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#text-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Element#text-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # Driver support by platform
@@ -65,7 +60,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -12,7 +12,7 @@ example_usage:
      MobileElement elementTwo = (MobileElement) driver.findElementByClassName("SomeClassName");
  python:
    |
-      el = self.driver.find_element_by_accessibility_id('SomeAccessibilityID')
+      el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="SomeAccessibilityID")
  javascript_wd:
    |
      let elementOne = await driver.elementByAccessibilityId("SomeAccessibilityID");
@@ -26,9 +26,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_element(:accessibility_id, 'SomeAccessibilityID')
-  php:
-    |
-      $el = $this->byAccessibilityId('SomeAccessibilityID');
  csharp:
    |
      AndroidElement elementOne = driver.FindElementByAccessibilityID("Some ID");
@@ -41,7 +38,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L745"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/SearchContext:find_element"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/SearchContext:find_element"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -61,7 +57,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -89,4 +84,4 @@ endpoint:
 # Links to specifications. Should link to at least one specification
 specifications:
  w3c: https://www.w3.org/TR/webdriver/#find-element
-  jsonwp: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidelement
+  jsonwp: https://www.selenium.dev/documentation/legacy/json_wire_protocol/#sessionsessionidelement
@@ -33,7 +33,7 @@ example_usage:
      List<MobileElement> elementsTwo = (List<MobileElement>) driver.findElementsByClassName("SomeClassName");
  python:
    |
-      el = self.driver.find_elements_by_accessibility_id('SomeAccessibilityID')
+      el = driver.find_elements(AppiumBy.ACCESSIBILITY_ID,'SomeAccessibilityID')
  javascript_wd:
    |
      let elementsOne = await driver.elementsByAccessibilityId("SomeAccessibilityID");
@@ -47,9 +47,6 @@ example_usage:
  ruby_core:
    |
      @driver.find_elements(:accessibility_id, "~SomeAccessibilityID")
-  php:
-    |
-      $els = $this->elements($this->using('accessibility id')->value('SomeAccessibilityID'));
  csharp:
    |
      IEnumerable<AppiumWebElement> elementsOne = driver.FindElementsByAccessibilityId("SomeAccessibilityID");
@@ -62,7 +59,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L798"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/SearchContext:find_elements"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/SearchContext:find_elements"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs"

 # Driver support by platform
@@ -82,7 +78,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -109,4 +104,4 @@ endpoint:
 # Links to specifications. Should link to at least one specification
 specifications:
  w3c: https://www.w3.org/TR/webdriver/#dfn-find-elements
-  jsonwp: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidelements
+  jsonwp: https://www.selenium.dev/documentation/legacy/json_wire_protocol/#sessionsessionidelements
@@ -21,9 +21,6 @@ example_usage:
  ruby_core:
    |
      @driver.switch_to.active_element
-  php:
-    |
-      // TODO PHP example
  csharp:
    |
      IWebElement currentElement = driver.SwitchTo().ActiveElement();
@@ -36,27 +33,25 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1934"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/0.0.28/Selenium/WebDriver/TargetLocator#active_element-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/0.0.28/Selenium/WebDriver/TargetLocator#active_element-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Remote/RemoteTargetLocator.cs"

 # Driver support by platform
 driver_support:
  ios:
-    xcuitest: false
+    xcuitest: true
    uiautomation: false
  android:
-    uiautomator2: false
-    espresso: false
+    uiautomator2: true
+    espresso: true
    uiautomator: false
  mac:
-    mac: false
+    mac: true
  windows:
    windows: false
 client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -65,7 +60,7 @@ client_support:
 # Information about the HTTP endpoints
 endpoint:
  url: /session/:session_id/element/active
-  method: 'POST'
+  method: "'GET'(W3C), 'POST'(JSONWP)"
  response:
    - name: ELEMENT
      type: object
@@ -33,9 +33,6 @@ example_usage:
      element1 = @driver.find_element :class_name, "someClass"
      element2 = @driver.find_element :class_name, "someOtherClass"
      element1 == element2
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var elementOne = driver.FindElementByClassName("SomeClassName");
@@ -49,7 +46,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1463"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/0.0.28/Selenium/WebDriver/Element#==-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/0.0.28/Selenium/WebDriver/Element#==-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Remote/RemoteWebElement.cs"

 # TODO: Confirm support for these per platform
@@ -69,7 +65,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -30,9 +30,6 @@ example_usage:
    |
      element = @driver.find_element :class_name, "someClass"
      element.submit element
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var element = driver.FindElementByClassName("SomeClassName");
@@ -45,7 +42,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1741"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/0.0.28/Selenium/WebDriver/Element#submit-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/0.0.28/Selenium/WebDriver/Element#submit-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Remote/RemoteWebElement.cs"

 # Driver support by platform
@@ -65,7 +61,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -26,9 +26,6 @@ example_usage:
  ruby_core:
    |
      # Ruby Code in ruby_lib_core here
-  php:
-    |
-      // PHP Code here
  csharp:
    |
      driver.FindElementById("elementId").Click();
@@ -41,7 +38,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/releases"
  ruby: "https://github.com/appium/ruby_lib/releases/latest"
  ruby_core: "https://github.com/appium/ruby_lib/releases/latest"
-  php: "https://github.com/appium/php-client/releases/latest"
  csharp: "https://github.com/appium/appium" # TODO

 # Driver support by platform
@@ -70,7 +66,6 @@ client_support:
  python:
    min: 2
  ruby: true # If true, means it supports all
-  php: false # If false(y), means it is not supported


 # Information about the HTTP endpoints
@@ -29,6 +29,8 @@ example_usage:
      driver.perform(Arrays.asList(dragNDrop));
  python:
    |
+      from selenium.webdriver.common.action_chains import ActionChains
+      
      element = driver.find_element_by_accessibility_id("elId")
      actions = ActionChains(driver)
      actions.move_to_element(element)
@@ -96,18 +98,18 @@ example_usage:
      # Build multiple action chains
      # Example: expressing a 1-second pinch-and-zoom
      # with a 500ms wait after the fingers first touch:
-      f1 = action.add_pointer_input(:touch, 'finger1')
+      f1 = ::Selenium::WebDriver::Interactions.pointer(:touch, name: 'finger1')
      f1.create_pointer_move(duration: 1, x: 200, y: 500, origin: ::Selenium::WebDriver::Interactions::PointerMove::VIEWPORT)
      f1.create_pointer_down(:left)
      f1.create_pause(0.5)
      f1.create_pointer_move(duration: 1, x: 200, y: 200, origin: ::Selenium::WebDriver::Interactions::PointerMove::VIEWPORT)
      f1.create_pointer_up(:left)

-      f2 = action.add_pointer_input(:touch, 'finger2')
+      f2 = ::Selenium::WebDriver::Interactions.pointer(:touch, name: 'finger2')
      f2.create_pointer_move(duration: 1, x: 200, y: 500, origin: ::Selenium::WebDriver::Interactions::PointerMove::VIEWPORT)
      f2.create_pointer_down(:left)
      f2.create_pause(0.5)
-      f2.create_pointer_move(duration: 1, x: 200, y: 800, origin: ::Selenium::Web@Driver::Interactions::PointerMove::VIEWPORT)
+      f2.create_pointer_move(duration: 1, x: 200, y: 800, origin: ::Selenium::WebDriver::Interactions::PointerMove::VIEWPORT)
      f2.create_pointer_up(:left)

      perform_actions [f1, f2]
@@ -123,14 +125,14 @@ example_usage:
      # Build multiple action chains
      # Example: expressing a 1-second pinch-and-zoom
      # with a 500ms wait after the fingers first touch:
-      f1 = @driver.action.add_pointer_input(:touch, 'finger1')
+      f1 = ::Selenium::WebDriver::Interactions.pointer(:touch, name: 'finger1')
      f1.create_pointer_move(duration: 1, x: 200, y: 500, origin: ::Selenium::WebDriver::Interactions::PointerMove::VIEWPORT)
      f1.create_pointer_down(:left)
      f1.create_pause(0.5)
      f1.create_pointer_move(duration: 1, x: 200, y: 200, origin: ::Selenium::WebDriver::Interactions::PointerMove::VIEWPORT)
      f1.create_pointer_up(:left)

-      f2 = @driver.action.add_pointer_input(:touch, 'finger2')
+      f2 = ::Selenium::WebDriver::Interactions.pointer(:touch, name: 'finger2')
      f2.create_pointer_move(duration: 1, x: 200, y: 500, origin: ::Selenium::WebDriver::Interactions::PointerMove::VIEWPORT)
      f2.create_pointer_down(:left)
      f2.create_pause(0.5)
@@ -138,9 +140,6 @@ example_usage:
      f2.create_pointer_up(:left)

      @driver.perform_actions [f1, f2]
-  php:
-    |
-      // TODO
  csharp:
    |
      var inputDevice = new PointerInputDevice(PointerKind.Touch);
@@ -160,7 +159,6 @@ client_docs:
  #javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L44"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/W3CActionBuilder"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/W3CActionBuilder"
-  php: "https://github.com/jupeter/selenium-php-webdriver/blob/master/Webdriver/Common/ActionChains.php"
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO

 # Driver support by platform
@@ -180,7 +178,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -34,9 +34,6 @@ example_usage:
  ruby_core:
    |
      @driver.action.move_to(element).click_and_hold.perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      Actions action = new Actions(driver);
@@ -51,7 +48,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1625"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/ActionBuilder:click_and_hold"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/ActionBuilder:click_and_hold"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/Actions.cs"

 # Driver support by platform
@@ -71,7 +67,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -42,9 +42,6 @@ example_usage:
  ruby_core:
    |
      @driver.action.click_and_hold(el).move_to(el, 10, 10).release.perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      Actions action = new Actions(driver);
@@ -61,7 +58,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1645"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/ActionBuilder:release"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/ActionBuilder:release"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/Actions.cs"

 # Driver support by platform
@@ -81,7 +77,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -29,9 +29,6 @@ example_usage:
  ruby_core:
    |
      @driver.action.move_to(element).click.perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      Actions action = new Actions(driver);
@@ -39,8 +36,6 @@ example_usage:
      action.Click();
      action.Perform();

-
-
 client_docs:
  java: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/Actions.html#click--"
  python: "http://selenium-python.readthedocs.io/api.html#selenium.webdriver.common.action_chains.ActionChains.click"
@@ -48,7 +43,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1665"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Mouse:click"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Mouse:click"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -68,7 +62,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -29,9 +29,6 @@ example_usage:
  ruby_core:
    |
      @driver.action.move_to(element).double_click.perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      Actions action = new Actions(driver);
@@ -46,7 +43,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1686"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/ActionBuilder:double_click"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/ActionBuilder:double_click"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/Actions.cs"

 # Driver support by platform
@@ -66,7 +62,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -32,9 +32,6 @@ example_usage:
    |
      @driver.mouse.move_to(element)
      @driver.mouse.move_to(element, 5, 5)
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      Actions action = new Actions(driver);
@@ -50,7 +47,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1600"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Mouse:move_to"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Mouse:move_to"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -70,7 +66,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -32,9 +32,6 @@ example_usage:
  ruby_core:
    |
      @driver.touch_action.double_tap(element).perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      TouchActions action = new TouchActions(driver);
@@ -42,13 +39,12 @@ example_usage:
      action.Perform();

 client_docs:
-  java: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/touch/TouchActions.html#doubleTap-org.openqa.selenium.WebElement-"
-  python: "https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.touch_actions.html#selenium.webdriver.common.touch_actions.TouchActions.double_tap"
+  java: "https://www.selenium.dev/selenium/docs/api/java/overview-summary.html"
+  python: "https://selenium-python.readthedocs.io/api.html?highlight=tap_and_hold#selenium.webdriver.common.touch_actions.TouchActions.double_tap"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L425"
  javascript_wdio: "https://webdriver.io/docs/api/jsonwp.html#touchdoubleclick"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:double_tap"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:double_tap"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/TouchActions.cs"

 # Driver support by platform
@@ -68,7 +64,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -27,9 +27,6 @@ example_usage:
  ruby_core:
    |
      @driver.touch_action.flick(element, 1, 10, 10).perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      TouchActions action = new TouchActions(driver);
@@ -38,12 +35,11 @@ example_usage:

 client_docs:
  java: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/touch/TouchActions.html#flick-org.openqa.selenium.WebElement-int-int-int-"
-  python: "https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.touch_actions.html#selenium.webdriver.common.touch_actions.TouchActions.flick_element"
+  python: "https://selenium-python.readthedocs.io/api.html#selenium.webdriver.common.touch_actions.TouchActions.flick_element"
  javascript_wdio: "https://webdriver.io/docs/api/jsonwp.html#touchflick"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1513"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:flick"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:flick"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/TouchActions.cs"

 # Driver support by platform
@@ -63,7 +59,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -35,9 +35,6 @@ example_usage:
  ruby_core:
    |
      @driver.touch_action.long_press(element).perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      var touchAction = new TouchAction(Driver);
@@ -45,12 +42,11 @@ example_usage:

 client_docs:
  java: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/touch/TouchActions.html#longPress-org.openqa.selenium.WebElement-"
-  python: "https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.touch_actions.html#selenium.webdriver.common.touch_actions.TouchActions.long_press"
+  python: "https://selenium-python.readthedocs.io/api.html#selenium.webdriver.common.touch_actions.TouchActions.long_press"
  javascript_wdio: "https://webdriver.io/docs/api/mjsonwp.html#touchperform"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1531"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:long_press"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:long_press"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -70,7 +66,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -40,9 +40,6 @@ example_usage:
  ruby_core:
    |
      @driver.touch_action.down(element).move_to().perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      TouchActions action = new TouchActions(driver);
@@ -52,12 +49,11 @@ example_usage:

 client_docs:
  java: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/touch/TouchActions.html#down-int-int-"
-  python: "https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.touch_actions.html#selenium.webdriver.common.touch_actions.TouchActions.move"
+  python: "https://selenium-python.readthedocs.io/api.html#module-selenium.webdriver.common.touch_actions"
  javascript_wdio: "https://webdriver.io/docs/api/mjsonwp.html#multitouchperform"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1531"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:move"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:move"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/TouchActions.cs"

 # Driver support by platform
@@ -77,7 +73,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -2,6 +2,10 @@
 name: Multi Touch Perform
 short_description: Perform a multi touch action sequence

+description:
+  |
+    Deprecated. Please consider using [W3C Actions](/docs/en/commands/interactions/actions.md)
+
 example_usage:
  java:
    |
@@ -55,9 +59,6 @@ example_usage:
  ruby_core:
    |
      @driver.multi_touch.down(element).move_to(10, 100).up(50, 50).perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      // TODO C# sample
@@ -69,7 +70,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1546"
  ruby: "https://www.rubydoc.info/github/appium/ruby_lib/Appium/MultiTouch"
  ruby_core: "https://www.rubydoc.info/github/appium/ruby_lib/Appium/MultiTouch"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -89,7 +89,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -28,9 +28,6 @@ example_usage:
  ruby_core:
    |
      @driver.touch_actions.scroll(element, 10, 100).perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      TouchActions action = new TouchActions(driver);
@@ -39,12 +36,11 @@ example_usage:

 client_docs:
  java: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/touch/TouchActions.html#scroll-int-int-"
-  python: "https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.touch_actions.html#selenium.webdriver.common.touch_actions.TouchActions.scroll"
+  python: "https://selenium-python.readthedocs.io/api.html#selenium.webdriver.common.touch_actions.TouchActions.scroll"
  javascript_wdio: "https://webdriver.io/docs/api/jsonwp.html#touchscroll"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L425"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:scroll"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:scroll"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/TouchActions.cs"

 # Driver support by platform
@@ -64,7 +60,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -37,9 +37,6 @@ example_usage:
  ruby_core:
    |
      @driver.touch_action.single_tap(element).perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      TouchAction touchAction = new TouchAction(driver);
@@ -52,7 +49,6 @@ client_docs:
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1531"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:single_tap"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium%2FWebDriver%2FTouchActionBuilder:single_tap"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/appium/appium-dotnet-driver/" # TODO Dotnet documentation link

 # Driver support by platform
@@ -72,7 +68,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
@@ -36,9 +36,6 @@ example_usage:
  ruby_core:
    |
      @driver.touch_action.down(element).move().perform
-  php:
-    |
-      // TODO PHP sample
  csharp:
    |
      TouchActions action = new TouchActions(driver);
@@ -48,12 +45,11 @@ example_usage:

 client_docs:
  java: "https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/touch/TouchActions.html#down-int-int-"
-  python: "https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.touch_actions.html#selenium.webdriver.common.touch_actions.TouchActions.tap_and_hold"
+  python: "https://selenium-python.readthedocs.io/api.html?highlight=tap_and_hold#selenium.webdriver.common.touch_actions.TouchActions.tap_and_hold"
  javascript_wdio: "https://webdriver.io/docs/api/jsonwp.html#touchdown"
  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L1546"
  ruby: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/TouchActionBuilder#down-instance_method"
  ruby_core: "https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/TouchActionBuilder#down-instance_method"
-  php: "https://github.com/appium/php-client/" # TODO PHP documentation link
  csharp: "https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/Interactions/TouchActions.cs"

 # Driver support by platform
@@ -73,7 +69,6 @@ client_support:
  java: true
  python: true
  ruby: true
-  php: true
  csharp: true
  javascript_wd: true
  javascript_wdio: true
--- a/Show More
+++ b/Show More