From 054f81eacff85c98aaad218cd1dd8ac871be0694 Mon Sep 17 00:00:00 2001
From: "di.smirnov" <di.smirnov@corp.vk.com>
Date: Fri, 24 Jan 2025 15:59:51 +0300
Subject: [PATCH 1/2] update doc

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 0440e683ee..265d1019b5 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,12 @@ The easiest way to run the provider is to do
 
 Note: some features require direct access to the provider instance from the browser, so if you are running the provider on a different machine - make sure you pass accessible url to the --public-ip.
 
+For iOS support:
+1) You need to set up macOS node (for example we use Mac Mini on Intel Processor)
+2) Then clone and build this repo
+3) Also, you need to install pymobiledevice3
+4) Now see [run-wda.sh](./lib/cli/ios-device/run-wda.sh) Note: You need to create you own provisioning profile in XCode
+
 ## Features
 
 ### Database

From faf6e30bfa71a0ad01e627afbd3a73a9c9517ddf Mon Sep 17 00:00:00 2001
From: "di.smirnov" <di.smirnov@corp.vk.com>
Date: Fri, 24 Jan 2025 16:07:49 +0300
Subject: [PATCH 2/2] update doc

---
 README.md         |  2 +-
 doc/ios-device.md | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+), 1 deletion(-)
 create mode 100644 doc/ios-device.md

diff --git a/README.md b/README.md
index 265d1019b5..ab79aab5fd 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ For iOS support:
 1) You need to set up macOS node (for example we use Mac Mini on Intel Processor)
 2) Then clone and build this repo
 3) Also, you need to install pymobiledevice3
-4) Now see [run-wda.sh](./lib/cli/ios-device/run-wda.sh) Note: You need to create you own provisioning profile in XCode
+4) Now see [iOS doc](./doc/ios-device.md)
 
 ## Features
 
diff --git a/doc/ios-device.md b/doc/ios-device.md
new file mode 100644
index 0000000000..df4bd13750
--- /dev/null
+++ b/doc/ios-device.md
@@ -0,0 +1,35 @@
+# iOS device launch via run-wda.sh
+
+This script is designed to set up and run WebDriverAgent on an iOS device using `idb` and `pymobiledevice3`. It also sets up port forwarding for interacting with the device via `stf`.
+
+## Requirements
+
+- Installed `git`
+- Installed `idb`
+- Installed `pymobiledevice3`
+- Installed `xcodebuild`
+- Installed `stf`
+- Access to MongoDB which used by stf
+  Note: You need to create you own provisioning profile in XCode
+## Usage
+
+```bash
+./run-wda.sh
+```
+or
+
+```bash
+./run-wda.sh [deviceId] [deviceNum]
+```
+
+## Determine the device identifier:
+
+If deviceId is not specified, the script attempts to determine the first connected iOS device using idb list-targets.
+
+## Determine the device name:
+
+The device name is determined using idb list-targets.
+
+## Port forwarding:
+
+pymobiledevice3 is used to forward ports 9100 and 8100 (or their variations depending on deviceNum) to the device.