diff --git a/.gitignore b/.gitignore
index 502a20c..de4c08c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,3 +9,4 @@ coverage
# custom
temp
+.DS_Store
diff --git a/README.md b/README.md
index 52cdceb..f6417f4 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,18 @@ You can also use a reusable workflow to enable this action in your repository de
## Use the Action to trigger a new test on TestIO from a PR
-To trigger a test on TestIO multiple steps are required:
+We highly recommend creating a separate product in your TestIO account dedicated to test creation from a PR.
+This avoids interference with the tests in your main product(s).
+You can easily achieve that via the menu as can be seen in the following screenshot.
+
+
+
+### For the Default Devices in Your Account
+
+In the product you dedicate for triggering tests from PRs we recommend configuring the default devices so that
+they correspond to your required Desktop test environments. Refer to the [FAQs](#faqs) how to achieve this.
+
+To trigger a test on TestIO for your default devices the following steps are required:
1. Add the comment `@bot-testio exploratory-test create` to the PR from which the test should be triggered.
@@ -64,6 +75,36 @@ To trigger a test on TestIO multiple steps are required:
5. This triggers the test on TestIO and successful creation is commented back as a new comment.
+### For Android Devices
+
+To trigger a test on TestIO explicitly for Android devices the same steps as described for [Default Devices](#for-the-default-devices-in-your-account)
+need to be followed but with the following small adjustment:
+
+- The comment to be added to trigger the whole process from step 1 needs to be `@bot-testio exploratory-test create android`.
+- In addition to the other requested information you now need to provide the following:
+ ```json
+ "native": {
+ "android": {
+ "min": 8,
+ "max": 10
+ }
+ }
+ ```
+- You need to provide minimal and maximum Android version of devices the testers should use.
+- Only `integer` values are allowed.
+- `min` is mandatory and `max` optional.
+- If `max` is not provided TestIO automatically sets it to `latest`.
+
+## FAQs
+
+
+How/Where to configure the default devices on TestIO?
+Find the Default Devices in the menu as can be seen in the following screenshot.
+
+
+
+
+
## Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
diff --git a/docs/assets/images/testio-create-product.png b/docs/assets/images/testio-create-product.png
new file mode 100644
index 0000000..0993052
Binary files /dev/null and b/docs/assets/images/testio-create-product.png differ
diff --git a/docs/assets/images/testio-manage-default-devices.png b/docs/assets/images/testio-manage-default-devices.png
new file mode 100644
index 0000000..9ec92f6
Binary files /dev/null and b/docs/assets/images/testio-manage-default-devices.png differ