From 1686fa71d044829cbeca83058b50c5e700a1da1c Mon Sep 17 00:00:00 2001
From: Davert <davert.php@resend.cc>
Date: Sun, 4 Jun 2017 01:58:25 +0300
Subject: [PATCH 1/2] updated Appium documentation, removed Appium from
 travis.yml

---
 .travis.yml                 |    1 -
 docs/helpers/Appium.md      | 1587 +++++++----------------------------
 docs/helpers/WebDriverIO.md |  230 +++--
 lib/helper/Appium.js        |  350 +++++++-
 test/helper/Appium_test.js  |    4 +-
 5 files changed, 746 insertions(+), 1426 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index cbc1b32b0..645e172fe 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -13,7 +13,6 @@ env:
   - HELPER=Nightmare
   - HELPER=SeleniumWebdriver
   - HELPER=WebDriverIO
-  - HELPER=Appium
 addons:
   apt:
     packages:
diff --git a/docs/helpers/Appium.md b/docs/helpers/Appium.md
index 63dd4bb15..99cc56237 100644
--- a/docs/helpers/Appium.md
+++ b/docs/helpers/Appium.md
@@ -1,1611 +1,588 @@
-Appium helper is extends from WebriverIO. It's support all browser methods and also includes special methods for mobile apps testing. You can use this helper to test Web on desktop and mobile devices and mobile apps.
+# Appium
 
-#### Appium Installation
-
-Appium is an open source test automation framework for use with native, hybrid and mobile web apps that implements the WebDriver protocol.
-It allows you to run Selenium tests on mobile devices and also test native, hybrid and mobile web apps.
-
-1.  Download and install [Appium](http://appium.io/)
-
-    ```
-    npm i -g appium
-    ```
-2. Download and install Android SDK or Android Studio to manage emulators from [Android Studio site](https://developer.android.com/studio/index.html#downloads)
-3. Set the $ANDROID_HOME env variable to your Android SDK path
-
-    Example:
-    ```
-     export ANDROID_HOME=/Users/bestUser/Library/Android/sdk
-    ```
-4. Add Android SDK tools to $PATH
-
-    Example:
-    ```
-    export PATH="${ANDROID_HOME}/tools:$PATH"
-    export PATH="${ANDROID_HOME}/tools/bin:$PATH"
-    ```
-5. Add Java Home bin directory to $PATH
-
-    Example:
-    ```
-    export PATH="${JAVA_HOME}/bin:$PATH"
-    ```
-6. Create and launch emulator:
-    
-    From Android Studio:
-    * Create any empty android application
-    * Create emulator using this [documentation](https://developer.android.com/studio/run/managing-avds.html)
-   * Note that x86 emulators works much faster as ARM emulators, but you can use them only on Mac and Linux.
-   * Launch emulator from interface
-   
-    From Command line:
-   * Create emulator using [avdmanager commandline tool](https://developer.android.com/studio/command-line/avdmanager.html)
-   * Launch emulator using [emulator commandline tool](https://developer.android.com/studio/run/emulator-commandline.html)
-7. Test that Appium is installed correctly using `appium-doctor`
-
-    ```
-    npm i -g appium-doctor
-    appium-doctor
-    ```
-    If there are any issues, you have to fix them before Appium launch
-
-8.  Launch the daemon: `appium`
-9. Also on Mac you can launch tests for iOS devices. For this, install xcode from App store. You can get detailed information [here](http://appium.io/slate/en/master/?ruby#running-appium-on-mac-os-x)
-
-
-
-### Configuration
-
-This helper should be configured in codecept.conf.js
-
-#### Appium configuration
-
--   `port`: Appium server port
--   `restart`: restart browser or app between tests (default: true), if set to false cookies will be cleaned but browser window will be kept and for apps nothing will be changed.
--   `desiredCapabilities`: Appium capabilities
---   `platformName` - Which mobile OS platform to use
---   `appPackage` - Java package of the Android app you want to run
---   `appActivity` - Activity name for the Android activity you want to launch from your package.
---   `deviceName`: The kind of mobile device or emulator to use
---   `platformVersion`: Mobile OS version
---   `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
---   `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
-
-Example:
-
-```js
- {
-   helpers: {
-       Appium: {
-           desiredCapabilities: {
-               platformName: "Android",
-               appPackage: "com.example.android.myApp",
-               appActivity: "MainActivity",
-               deviceName: "OnePlus3",
-               platformVersion: "6.0.1"
-           },
-           port: 4723,
-           restart: false
-       }
-    }
- }
-```
-Additional configuration params can be used from <https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md>
-
-
-## Access From Helpers
-
-Receive a Appium client from a custom helper by accessing `browser` property:
-
-```js
-this.helpers['Appium'].browser
-```
-
-**Parameters**
-
--   `config`
-
-## _locate
-
-Get elements by different locator types, including strict locator
-Should be used in custom helpers:
-
-```js
-this.helpers['Appium']._locate({name: 'password'}).then //...
-```
-
-**Parameters**
-
--   `locator`  
-
-## _locateCheckable
-
-Find a checkbox by providing human readable text:
-
-```js
-this.helpers['Appium']._locateCheckable('I agree with terms and conditions').then // ...
-```
-
-**Parameters**
-
--   `locator`  
-
-## _locateClickable
-
-Find a clickable element by providing human readable text:
-
-```js
-this.helpers['Appium']._locateClickable('Next page').then // ...
-```
-
-**Parameters**
-
--   `locator`  
-
-## _locateFields
-
-Find field elements by providing human readable text:
-
-```js
-this.helpers['Appium']._locateFields('Your email').then // ...
-```
-
-**Parameters**
-
--   `locator`  
-
-## acceptPopup
-
-Accepts the active JavaScript native popup window, as created by window.alert|window.confirm|window.prompt.
-Don't confuse popups with modal windows, as created by [various libraries](http://jster.net/category/windows-modals-popups).
-
-Appium: support only web testing
-
-## amOnPage
-
-Opens a web page in a browser. Requires relative or absolute url.
-If url starts with `/`, opens a web page of a site defined in `url` config parameter.
-
-Appium: support only web testing
-
-```js
-I.amOnPage('/'); // opens main page of website
-I.amOnPage('https://github.com'); // opens github
-I.amOnPage('/login'); // opens a login page
-```
-
-**Parameters**
-
--   `url`  url path or global url
-
-## appendField
-
-Appends text to a input field or textarea.
-Field is located by name, label, CSS or XPath
-
-Appium: support, but it's clear a field before insert in apps
-
-```js
-I.appendField('#myTextField', 'appended');
-```
-
-**Parameters**
-
--   `field`  located by label|name|CSS|XPath|strict locator
--   `value`  text value
-
-## attachFile
-
-Attaches a file to element located by label, name, CSS or XPath
-Path to file is relative current codecept directory (where codecept.json is located).
-File will be uploaded to remote system (if tests are running remotely).
-
-Appium: not tested
-
-```js
-I.attachFile('Avatar', 'data/avatar.jpg');
-I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
-```
-
-**Parameters**
-
--   `locator`  field located by label|name|CSS|XPath|strict locator
--   `pathToFile`  local file path relative to codecept.json config file
-
-## cancelPopup
-
-Dismisses the active JavaScript popup, as created by window.alert|window.confirm|window.prompt.
-
-Appium: support only web testing
-
-## checkOption
-
-Selects a checkbox or radio button.
-Element is located by label or name or CSS or XPath.
-
-Appium: support only web testing
-
-The second parameter is a context (CSS or XPath locator) to narrow the search.
-
-```js
-I.checkOption('#agree');
-I.checkOption('I Agree to Terms and Conditions');
-I.checkOption('agree', '//form');
-```
-
-**Parameters**
-
--   `field`  checkbox located by label | name | CSS | XPath | strict locator
--   `context`  (optional) element located by CSS | XPath | strict locator
-
-## clearCookie
-
-Clears a cookie by name,
-if none provided clears all cookies
-
-Appium: support only web testing
-
-```js
-I.clearCookie();
-I.clearCookie('test');
-```
-
-**Parameters**
-
--   `cookie`  (optional)
-
-## clearField
-
-Clears a `<textarea>` or text `<input>` element's value.
-
-Appium: support
-
-```js
-I.clearField('#email');
-```
-
-**Parameters**
-
--   `locator`  field located by label|name|CSS|XPath|strict locator
-
-## click
-
-Perform a click on a link or a button, given by a locator.
-If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
-For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
-For images, the "alt" attribute and inner text of any parent links are searched.
-
-Appium: support
-
-The second parameter is a context (CSS or XPath locator) to narrow the search.
-
-```js
-// simple link
-I.click('Logout');
-// button of form
-I.click('Submit');
-// CSS button
-I.click('#form input[type=submit]');
-// XPath
-I.click('//form/*[@type=submit]');
-// link in context
-I.click('Logout', '#nav');
-// using strict locator
-I.click({css: 'nav a.login'});
-```
-
-**Parameters**
-
--   `locator`  clickable link or button located by text, or any element located by CSS|XPath|strict locator
--   `context`  (optional) element to search in CSS|XPath|Strict locator
-
-## defineTimeout
-
-Set [WebDriverIO timeouts](http://webdriver.io/guide/testrunner/timeouts.html) in realtime.
-
-Appium: support only web testing
-
-Timeouts are expected to be passed as object:
-
-```js
-I.defineTimeout({ script: 5000 });
-I.defineTimeout({ implicit: 10000, "page load": 10000, script: 5000 });
-```
-
-**Parameters**
-
--   `timeouts`  
-
-## dontSee
-
-Opposite to `see`. Checks that a text is not present on a page.
-Use context parameter to narrow down the search.
-
-Appium: support with context in apps
-
-```js
-I.dontSee('Login'); // assume we are already logged in
-```
-
-**Parameters**
-
--   `text`  is not present
--   `context`  (optional) element located by CSS|XPath|strict locator in which to perfrom search
-
-## dontSeeCheckboxIsChecked
-
-Verifies that the specified checkbox is not checked.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `field`  located by label|name|CSS|XPath|strict locator
-
-## dontSeeCookie
-
-Checks that cookie with given name does not exist.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `name`  
-
-## dontSeeCurrentUrlEquals
-
-Checks that current url is not equal to provided one.
-If a relative url provided, a configured url will be prepended to it.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `url`  
-
-## dontSeeElement
-
-Opposite to `seeElement`. Checks that element is not visible
-
-Appium: support
-
-**Parameters**
-
--   `locator`  located by CSS|XPath|Strict locator
-
-## dontSeeElementInDOM
-
-Opposite to `seeElementInDOM`. Checks that element is not on page.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `locator`  located by CSS|XPath|Strict locator
-
-## dontSeeInCurrentUrl
-
-Checks that current url does not contain a provided fragment.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `url`  
-
-## dontSeeInField
-
-Checks that value of input field or textare doesn't equal to given value
-Opposite to `seeInField`.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `field`  located by label|name|CSS|XPath|strict locator
--   `value`  is not expected to be a field value
-
-## dontSeeInSource
-
-Checks that the current page contains the given string in its raw source code
-
-Appium: support
-
-**Parameters**
-
--   `text`  
-
-## dontSeeInTitle
-
-Checks that title does not contain text.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `text`  
-
-## doubleClick
-
-Performs a double-click on an element matched by link|button|label|CSS or XPath.
-Context can be specified as second parameter to narrow search.
-
-Appium: support only web testing
-
-```js
-I.doubleClick('Edit');
-I.doubleClick('Edit', '.actions');
-I.doubleClick({css: 'button.accept'});
-I.doubleClick('.btn.edit');
-```
-
-**Parameters**
-
--   `locator`  
--   `context`  
-
-## dragAndDrop
-
-Drag an item to a destination element.
-
-Appium: not tested
-
-```js
-I.dragAndDrop('#dragHandle', '#container');
-```
-
-**Parameters**
-
--   `srcElement`  
--   `destElement`  
-
-## executeAsyncScript
-
-Executes async script on page.
-Provided function should execute a passed callback (as first argument) to signal it is finished.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `fn`  
--   `args`  Examples for Vue.js.
-    In order to make components completely rendered we are waiting for [nextTick](https://vuejs.org/v2/api/#Vue-nextTick).```js
-    I.executeAsyncScript(function(done) {
-    Vue.nextTick(done); // waiting for next tick
-    })
-    ```By passing value to `done()` function you can return values.
-    Additional arguments can be passed as well, while `done` function is always last parameter in arguments list.```js
-    let val = yield I.executeAsyncScript(function(url, done) {
-    // in browser context
-    $.ajax(url, { success: (data) => done(data); }
-    }, 'http://ajax.callback.url/');
-    ```
-
-## executeScript
-
-Executes sync script on a page.
-Pass arguments to function as additional parameters.
-Will return execution result to a test.
-In this case you should use generator and yield to receive results.
-
-Appium: support only web testing
-
-Example with jQuery DatePicker:
-
-```js
-// change date of jQuery DatePicker
-I.executeScript(function() {
-// now we are inside browser context
-$('date')).datetimepicker('setDate', new Date());
-});
-```
-
-Can return values. Don't forget to use `yield` to get them.
-
-```js
-let date = yield I.executeScript(function(el) {
-// only basic types can be returned
-return $(el)).datetimepicker('getDate').toString();
-}, '#date'); // passing selector
-```
-
-**Parameters**
-
--   `fn`  
-
-## fillField
-
-Fills a text field or textarea, after clearing its value, with the given string.
-Field is located by name, label, CSS, or XPath.
-
-Appium: support
-
-```js
-// by label
-I.fillField('Email', 'hello@world.com');
-// by name
-I.fillField('password', '123456');
-// by CSS
-I.fillField('form#login input[name=username]', 'John');
-// or by strict locator
-I.fillField({css: 'form#login input[name=username]'}, 'John');
-```
-
-**Parameters**
-
--   `field`  located by label|name|CSS|XPath|strict locator
--   `value`  
-
-## grabAttributeFrom
-
-Retrieves an attribute from an element located by CSS or XPath and returns it to test.
-Resumes test execution, so **should be used inside a generator with `yield`** operator.
-
-Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
-
-```js
-let hint = yield I.grabAttributeFrom('#tooltip', 'title');
-```
-
-**Parameters**
-
--   `locator`  element located by CSS|XPath|strict locator
--   `attr`  
-
-## grabCookie
-
-Gets a cookie object by name
-Resumes test execution, so **should be used inside a generator with `yield`** operator.
-
-Appium: support only web testing
-
-```js
-let cookie = I.grabCookie('auth');
-assert(cookie.value, '123456');
-```
-
-**Parameters**
-
--   `name`  
-
-## grabHTMLFrom
-
-Retrieves the innerHTML from an element located by CSS or XPath and returns it to test.
-Resumes test execution, so **should be used inside a generator with `yield`** operator.
-
-Appium: support only web testing
-
-```js
-let postHTML = yield I.grabHTMLFrom('#post');
-```
-
-**Parameters**
-
--   `locator`  
-
-## grabTextFrom
-
-Retrieves a text from an element located by CSS or XPath and returns it to test.
-Resumes test execution, so **should be used inside a generator with `yield`** operator.
-
-Appium: support
-
-```js
-let pin = yield I.grabTextFrom('#pin');
-```
-
-**Parameters**
-
--   `locator`  element located by CSS|XPath|strict locator
-
-## grabTitle
-
-Retrieves a page title and returns it to test.
-Resumes test execution, so **should be used inside a generator with `yield`** operator.
-
-Appium: support only web testing
-
-```js
-let title = yield I.grabTitle();
-```
-
-## grabValueFrom
-
-Retrieves a value from a form element located by CSS or XPath and returns it to test.
-Resumes test execution, so **should be used inside a generator with `yield`** operator.
-
-Appium: support only web testing
-
-```js
-let email = yield I.grabValueFrom('input[name=email]');
-```
-
-**Parameters**
-
--   `locator`  field located by label|name|CSS|XPath|strict locator
-
-## moveCursorTo
-
-Moves cursor to element matched by locator.
-Extra shift can be set with offsetX and offsetY options
-
-Appium: support only web testing
-
-```js
-I.moveCursorTo('.tooltip');
-I.moveCursorTo('#submit', 5,5);
-```
-
-**Parameters**
-
--   `locator`  
--   `offsetX`  
--   `offsetY`  
-
-## pressKey
-
-Presses a key on a focused element.
-Speical keys like 'Enter', 'Control', [etc](https://code.google.com/p/selenium/wiki/JsonWireProtocol#/session/:sessionId/element/:id/value)
-will be replaced with corresponding unicode.
-If modifier key is used (Control, Command, Alt, Shift) in array, it will be released afterwards.
-
-Appium: support, but clear field before pressing in apps
-
-```js
-I.pressKey('Enter');
-I.pressKey(['Control','a']);
-```
-
-**Parameters**
-
--   `key`  To make combinations with modifier and mouse clicks (like Ctrl+Click) press a modifier, click, then release it.```js
-    I.pressKey('Control');
-    I.click('#someelement');
-    I.pressKey('Control');
-    ```
-
-## resizeWindow
-
-Resize the current window to provided width and height.
-First parameter can be set to `maximize`
-
-Appium: not tested in web, in apps doesn't work
-
-**Parameters**
-
--   `width`  or `maximize`
--   `height`  
-
-## rightClick
-
-Performs right click on an element matched by CSS or XPath.
-
-Appium: support, but in apps works as usual click
-
-**Parameters**
-
--   `locator`  
-
-## saveScreenshot
-
-Saves a screenshot to ouput folder (set in codecept.json).
-Filename is relative to output folder.
-
-Appium: support
-
-```js
-I.saveScreenshot('debug.png');
-```
-
-**Parameters**
-
--   `fileName`  
-
-## scrollTo
-
-Scrolls to element matched by locator.
-Extra shift can be set with offsetX and offsetY options
-
-Appium: support only web testing
-
-```js
-I.scrollTo('footer');
-I.scrollTo('#submit', 5,5);
-```
-
-**Parameters**
-
--   `locator`  
--   `offsetX`  
--   `offsetY`  
-
-## see
-
-Checks that a page contains a visible text.
-Use context parameter to narrow down the search.
-
-Appium: support with context in apps
-
-```js
-I.see('Welcome'); // text welcome on a page
-I.see('Welcome', '.content'); // text inside .content div
-I.see('Register', {css: 'form.register'}); // use strict locator
-```
-
-**Parameters**
-
--   `text`  expected on page
--   `context`  (optional) element located by CSS|Xpath|strict locator in which to search for text
-
-## seeCheckboxIsChecked
-
-Verifies that the specified checkbox is checked.
-
-Appium: support only web testing
-
-```js
-I.seeCheckboxIsChecked('Agree');
-I.seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms
-I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
-```
-
-**Parameters**
-
--   `field`  located by label|name|CSS|XPath|strict locator
-
-## seeCookie
-
-Checks that cookie with given name exists.
-
-Appium: support only web testing
-
-```js
-I.seeCookie('Auth');
-```
-
-**Parameters**
-
--   `name`  
-
-## seeCurrentUrlEquals
-
-Checks that current url is equal to provided one.
-
-Appium: support only web testing
-
-If a relative url provided, a configured url will be prepended to it.
-So both examples will work:
-
-```js
-I.seeCurrentUrlEquals('/register');
-I.seeCurrentUrlEquals('http://my.site.com/register');
-```
-
-**Parameters**
-
--   `url`  
-
-## seeElement
-
-Checks that a given Element is visible
-Element is located by CSS or XPath.
-
-Appium: support
-
-```js
-I.seeElement('#modal');
-```
-
-**Parameters**
-
--   `locator`  located by CSS|XPath|strict locator
-
-## seeElementInDOM
-
-Checks that a given Element is present in the DOM
-Element is located by CSS or XPath.
-
-Appium: support only web testing
-
-```js
-I.seeElementInDOM('#modal');
-```
-
-**Parameters**
-
--   `locator`  located by CSS|XPath|strict locator
-
-## seeInCurrentUrl
-
-Checks that current url contains a provided fragment.
-
-Appium: support only web testing
-
-```js
-I.seeInCurrentUrl('/register'); // we are on registration page
-```
-
-**Parameters**
-
--   `url`  
-
-## seeInField
-
-Checks that the given input field or textarea equals to given value.
-For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
-
-Appium: support only web testing
-
-```js
-I.seeInField('Username', 'davert');
-I.seeInField({css: 'form textarea'},'Type your comment here');
-I.seeInField('form input[type=hidden]','hidden_value');
-I.seeInField('#searchform input','Search');
-```
-
-**Parameters**
-
--   `field`  located by label|name|CSS|XPath|strict locator
--   `value`  
-
-## seeInPopup
-
-Checks that the active JavaScript popup, as created by `window.alert|window.confirm|window.prompt`, contains the given string.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `text`  
-
-## seeInSource
-
-Checks that the current page contains the given string in its raw source code.
-
-Appium: support
-
-```js
-I.seeInSource('<h1>Green eggs &amp; ham</h1>');
-```
-
-**Parameters**
-
--   `text`  
-
-## seeInTitle
-
-Checks that title contains text.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `text`  
-
-## seeNumberOfElements
-
-asserts that an element appears a given number of times in the DOM
-Element is located by label or name or CSS or XPath.
-
-Appium: support
-
-```js
-I.seeNumberOfElements('#submitBtn', 1);
-```
-
-**Parameters**
-
--   `selector`  
--   `num`  
-
-## selectOption
-
-Selects an option in a drop-down select.
-Field is searched by label | name | CSS | XPath.
-Option is selected by visible text or by value.
-
-Appium: support only web testing
-
-```js
-I.selectOption('Choose Plan', 'Monthly'); // select by label
-I.selectOption('subscription', 'Monthly'); // match option by text
-I.selectOption('subscription', '0'); // or by value
-I.selectOption('//form/select[@name=account]','Premium');
-I.selectOption('form select[name=account]', 'Premium');
-I.selectOption({css: 'form select[name=account]'}, 'Premium');
-```
-
-Provide an array for the second argument to select multiple options.
-
-```js
-I.selectOption('Which OS do you use?', ['Android', 'iOS']);
-```
-
-**Parameters**
-
--   `select`  field located by label|name|CSS|XPath|strict locator
--   `option`  
-
-## setCookie
-
-Sets a cookie
-
-Appium: support only web testing
-
-```js
-I.setCookie({name: 'auth', value: true});
-```
-
-**Parameters**
-
--   `cookie`  Uses Selenium's JSON [cookie format](https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object).
-
-## switchTo
-
-Switches frame or in case of null locator reverts to parent.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `locator`  
-
-## wait
-
-Pauses execution for a number of seconds.
-
-Appium: support
-
-```js
-I.wait(2); // wait 2 secs
-```
-
-**Parameters**
-
--   `sec`  
-
-## waitForElement
-
-Waits for element to be present on page (by default waits for 1sec).
-Element can be located by CSS or XPath.
+Appium helper extends [WebriverIO](http://codecept.io/helpers/WebDriverIO/) helper.
+It supports all browser methods and also includes special methods for mobile apps testing.
+You can use this helper to test Web on desktop and mobile devices and mobile apps.
 
-Appium: support
-
-```js
-I.waitForElement('.btn.continue');
-I.waitForElement('.btn.continue', 5); // wait for 5 secs
-```
-
-**Parameters**
-
--   `locator`  element located by CSS|XPath|strict locator
--   `sec`  time seconds to wait, 1 by default
-
-## waitForEnabled
-
-Waits for element to become enabled (by default waits for 1sec).
-Element can be located by CSS or XPath.
-
-Appium: support only web testing
-
-**Parameters**
-
--   `locator`  element located by CSS|XPath|strict locator
--   `sec`  time seconds to wait, 1 by default
-
-## waitForInvisible
-
-Waits for an element to become invisible on a page (by default waits for 1sec).
-Element can be located by CSS or XPath.
+#### Appium Installation
 
-Appium: support
+Appium is an open source test automation framework for use with native, hybrid and mobile web apps that implements the WebDriver protocol.
+It allows you to run Selenium tests on mobile devices and also test native, hybrid and mobile web apps.
 
-    I.waitForInvisible('#popup');
+Download and install [Appium](http://appium.io/)
 
-**Parameters**
+    npm install -g appium
 
--   `locator`  element located by CSS|XPath|strict locator
--   `sec`  time seconds to wait, 1 by default
+Launch the daemon: `appium`
 
-## waitForStalenessOf
+### Configuration
 
-Waits for an element to become not attached to the DOM on a page (by default waits for 1sec).
-Element can be located by CSS or XPath.
+This helper should be configured in codecept.conf.js
 
-Appium: support only web testing
+#### Appium configuration
 
-    I.waitForStalenessOf('#popup');
+-   `port`: Appium serverport
+-   `restart`: restart browser or app between tests (default: true), if set to false cookies will be cleaned but browser window will be kept and for apps nothing will be changed.
+-   `desiredCapabilities`: Appium capabilities
+    --   `platformName` - Which mobile OS platform to use
+    --   `appPackage` - Java package of the Android app you want to run
+    --   `appActivity` - Activity name for the Android activity you want to launch from your package.
+    --   `deviceName`: The kind of mobile device or emulator to use
+    --   `platformVersion`: Mobile OS version
+    --   `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
+    --   `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
 
-**Parameters**
+Example:
 
--   `locator`  element located by CSS|XPath|strict locator
--   `sec`  time seconds to wait, 1 by default
+```js
+{
+helpers: {
+WebDriverIO: {
+desiredCapabilities: {
+platformName: "Android",
+appPackage: "com.example.android.myApp",
+appActivity: "MainActivity",
+deviceName: "OnePlus3",
+platformVersion: "6.0.1"
+},
+port: 4723,
+restart: false
+}
+}
+}
+```
 
-## waitForText
+Additional configuration params can be used from <https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md>
 
-Waits for a text to appear (by default waits for 1sec).
-Element can be located by CSS or XPath.
-Narrow down search results by providing context.
+## Access From Helpers
 
-Appium: support
+Receive a Appium client from a custom helper by accessing `browser` property:
 
 ```js
-I.waitForText('Thank you, form has been submitted');
-I.waitForText('Thank you, form has been submitted', 5, '#modal');
+let browser = this.helpers['Appium'].browser
 ```
 
 **Parameters**
 
--   `text`  to wait for
--   `sec`  seconds to wait
--   `context`  element located by CSS|XPath|strict locator
-
-## waitForVisible
-
-Waits for an element to become visible on a page (by default waits for 1sec).
-Element can be located by CSS or XPath.
+-   `config`  
 
-Appium: support
-
-    I.waitForVisible('#popup');
+## closeApp
 
-**Parameters**
+Close the given application.
 
--   `locator`  element located by CSS|XPath|strict locator
--   `sec`  time seconds to wait, 1 by default
+```js
+I.closeApp();
+```
 
-## waitToHide
+Appium: support only iOS
 
-Waits for an element to become invisible on a page (by default waits for 1sec).
-Element can be located by CSS or XPath.
+## constructor
 
-Appium: support
+Appium Special Methods for Mobile only
 
 **Parameters**
 
--   `locator`  
--   `sec`  
-
-## waitUntil
-
-Waits for a function to return true (waits for 1sec by default).
-
-Appium: support
+-   `config`  
 
-**Parameters**
-
--   `fn`  
--   `sec`  
+## grabAllContexts
 
+Get list of all available contexts
 
-# Appium extra methods
+    let contexts = yield I.grabAllContexts();
 
-## seeAppIsInstalled
+Appium: support Android and iOS
 
-Check if an app is installed.
+## grabContext
 
-Appium: support only Android
+Retrieve current context
 
 ```js
-I.seeAppIsInstalled("com.MainApp");
+let context = yield I.grabContext();
 ```
 
-**Parameters**
-
--   `bundleId` -	ID of bundled app
-
-## seeAppIsNotInstalled
+Appium: support Android and iOS
 
-Check if an app is not installed.
+## grabCurrentActivity
 
-Appium: support only Android
+Get current device activity.
 
 ```js
-I.seeAppIsNotInstalled("com.MainApp");
+let activity = yield I.grabCurrentActivity();
 ```
 
-**Parameters**
-
--   `bundleId` -	ID of bundled app
-
-## seeCurrentActivityIs
+Appium: support only Android
 
-check current activity on an Android device.
+## grabNetworkConnection
 
-Appium: support only Android
+Get information about the current network connection (Data/WIFI/Airplane).
+The actual server value will be a number. However WebdriverIO additional
+properties to the response object to allow easier assertions.
 
 ```js
-I.seeCurrentActivityIs(".MainActivity");
+let con = yield I.grabNetworkConnection();
 ```
 
-**Parameters**
-
--   `currentActivity` -	expected current activity
-
-## seeDeviceIsLocked
+Appium: support only Android
 
-Check whether the device is locked.
+## grabOrientation
 
-Appium: support only Android
+Get current orientation.
 
 ```js
-I.seeDeviceIsLocked()
+let orientation = yield I.grabOrientation();
 ```
 
-## dontSeeDeviceIsLocked
+Appium: support Android and iOS
 
-Check whether the device is not locked.
+## grabSettings
 
-Appium: support only Android
+Get all the currently specified settings.
 
 ```js
-I.dontSeeDeviceIsLocked()
+let settings = yield I.grabSettings();
 ```
 
-## seeOrientationIs
+Appium: support Android and iOS
 
-Check the device orientation
+## hideDeviceKeyboard
 
-Appium: support Android and iOS
+Hide the keyboard.
 
 ```js
-I.seeOrientationIs("landscape");
+// taps outside to hide keyboard per default
+I.hideDeviceKeyboard();
+I.hideDeviceKeyboard('tapOutside');
+
+// or by pressing key
+I.hideDeviceKeyboard('pressKey', 'Done');
 ```
 
 **Parameters**
 
--   `orientation` -	expected orientation ("landscape" or "portrait")
-
-## closeApp
+-   `strategy`  desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)Appium: support Android and iOS
+-   `key`  
 
-Close the given application.
+## installApp
 
-Appium: support only iOS
+Install an app on device.
 
 ```js
-I.closeApp();
+I.installApp('/path/to/file.apk');
 ```
 
-## grabAllContexts
+**Parameters**
 
-Get list of all available contexts
+-   `path`  path to apk fileAppium: support only Android
 
-Appium: support Android and iOS
+## makeTouchAction
+
+The Touch Action API provides the basis of all gestures that can be
+automated in Appium. At its core is the ability to chain together ad hoc
+individual actions, which will then be applied to an element in the
+application on the device.
+[See complete documentation](http://webdriver.io/api/mobile/touchAction.html)
 
 ```js
-let contexts = yield I.grabAllContexts()
-/*
-['NATIVE_APP', 'WEBVIEW_io.selendroid.testapp']
-*/
+I.makeTouchAction("~buttonStartWebviewCD", 'tap');
 ```
 
-## grabContext
-
-Retrieve current context
-
 Appium: support Android and iOS
 
-```js
-let context = yield I.grabContext()
-/*
-'NATIVE_APP'
-*/
-```
+**Parameters**
 
-## grabCurrentActivity
+-   `locator`  
+-   `action`  
 
-Get current device activity.
+## openNotifications
 
-Appium: support only Android
+Open the notifications panel on the device.
 
 ```js
-let currentActivity = yield I.grabCurrentActivity()
-/*
-.ui.WalkthroughActivity
-*/
+I.openNotifications();
 ```
 
-## grabNetworkConnection
+Appium: support only Android
 
-Get informations about the current network connection (Data/WIFI/Airplane). The actual server value will be a number. However WebdriverIO additional properties to the response object to allow easier assertions.
+## pullFile
 
-Appium: support only Android
+Pulls a file from the device.
 
 ```js
-let networkConnection = yield I.grabNetworkConnection()
-/*
-{ status: 0,
-value: 6,
-sessionId: '24781a27-4d0e-45ee-b964-6b3934d63fb7',
-inAirplaneMode: false,
-hasWifi: true,
-hasData: true }
-*/
+I.pullFile('/storage/emulated/0/DCIM/logo.png', 'my/path');
+// save file to output dir
+I.pullFile('/storage/emulated/0/DCIM/logo.png', output_dir);
 ```
 
-## grabOrientation
-
-Get current orientation.
-
 Appium: support Android and iOS
 
-```js
-let orientation = yield I.grabOrientation()
-/*
-portrait
-*/
-```
+**Parameters**
 
-## grabSettings
+-   `path`  
+-   `dest`  
 
-Get all the currently specified settings
+## removeApp
 
-Appium: support only Android
+Remove an app from the device.
 
 ```js
-let settings = yield I.grabSettings()
-/*
-{ ignoreUnimportantViews: false }
-*/
+I.removeApp('com.example.android.apis');
 ```
 
-## hideDeviceKeyboard
+**Parameters**
 
-Hide the keyboard. (taps outside to hide keyboard per default)
+-   `bundleId`  String	ID of bundled appAppium: support only Android
 
-Appium: support Android and iOS
+## rotate
+
+Perform a rotation gesture centered on the specified element.
 
 ```js
-I.hideDeviceKeyboard('tapOutside');
-I.hideDeviceKeyboard('pressKey', 'Done');
+I.rotate(120, 120)
 ```
 
-**Parameters**
+See corresponding [webdriverio reference](http://webdriver.io/api/mobile/rotate.html).
 
--   `strategy` - desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)
--   `key` - key to close keyboard
+Appium: support only iOS
 
-## installApp
+**Parameters**
 
-Install an app on device.
+-   `x`  
+-   `y`  
+-   `duration`  
+-   `radius`  
+-   `rotation`  
+-   `touchCount`  
 
-Appium: support only Android
+## seeAppIsInstalled
+
+Check if an app is installed.
 
 ```js
-I.installApp('/path/to/my/App.apk');
+I.seeAppIsInstalled("com.example.android.apis");
 ```
 
 **Parameters**
 
--   `path` - path to Android application
-
-## makeTouchAction
+-   `bundleId`  String	ID of bundled appAppium: support only Android
 
-The Touch Action API provides the basis of all gestures that can be automated in Appium. At its core is the ability to chain together ad hoc individual actions, which will then be applied to an element in the application on the device.
-Full documentation http://webdriver.io/api/mobile/touchAction.html
+## seeAppIsNotInstalled
 
-Appium: support Android and iOS
+Check if an app is not installed.
 
 ```js
-I.makeTouchAction('//UITextbox', 'tap');
+I.seeAppIsNotInstalled("com.example.android.apis");
 ```
 
 **Parameters**
 
--   `locator` - selector to execute the touchAction on
--   `action` - action to execute
-
-## makeShake
+-   `bundleId`  String	ID of bundled appAppium: support only Android
 
-Perform a shake action on the device.
+## seeCurrentActivityIs
 
-Appium: support only iOS
+Check current activity on an Android device.
 
 ```js
-I.makeShake();
+I.seeCurrentActivityIs(".HomeScreenActivity")
 ```
 
-## openNotifications
-
-Open the notifications panel on the device.
-
 Appium: support only Android
 
-```js
-I.openNotifications()
-```
+**Parameters**
 
-## pullFile
+-   `currentActivity`  
 
-Pulls a file from the device.
+## seeDeviceIsLocked
 
-Appium: support Android and iOS
+Check whether the device is locked.
 
 ```js
-I.pullFile('/sdcard/myfile.txt', 'c:/tmp/myfile.txt');
+I.seeDeviceIsLocked();
 ```
 
-**Parameters**
-
--   `path` - device path to file
--   `dest` - destination path to file
-
-## removeApp
+Appium: support only Android
 
-Remove an app from the device.
+## seeDeviceIsUnlocked
 
-Appium: support only Android
+Check whether the device is not locked.
 
 ```js
-I.removeApp('com.Myapp');
+I.seeDeviceIsUnlocked();
 ```
 
-**Parameters**
-
--   `bundleId` -  bundle ID of application
-
-## rotate
-
-Perform a rotation gesture centered on the specified element.
+Appium: support only Android
 
-Appium: support only iOS
+## seeOrientationIs
 
-not tested
+Check the device orientation
 
 ```js
-I.rotate(114, 198);
+I.seeOrientationIs('PORTRAIT');
+I.seeOrientationIs('LANDSCAPE')
 ```
 
 **Parameters**
 
--   `x` -  x offset to use for the center of the rotate gesture (default 0)
--   `y` -  y offset to use for the center of the rotate gesture (default 0)
--   `duration` -  The length of hold time for the specified gesture, in seconds. (default 1)
--   `radius` -  The distance in points from the center to the edge of the circular path.
--   `rotation` -  The length of rotation in radians. (default pi (π))
--   `touchCount` -  The number of touches to use in the specified gesture. (Effectively, the number of fingers a user would use to make the specified gesture.) Valid values are 1 to 5. (default 2)
-
-**Parameters**
-
--   `seconds` -  number of seconds after the app will open again
+-   `orientation`  LANDSCAPE or PORTRAITAppium: support Android and iOS
 
 ## sendDeviceKeyEvent
 
-Send a key event to the device
-list of keys: https://developer.android.com/reference/android/view/KeyEvent.html
-
-Appium: support only Android
+Send a key event to the device.
+List of keys: <https://developer.android.com/reference/android/view/KeyEvent.html>
 
 ```js
-I.sendDeviceKeyEvent(3)
+I.sendDeviceKeyEvent(3);
 ```
 
 **Parameters**
 
--   `keyValue` - device specific key value.
+-   `keyValue`  Device specifc key valueAppium: support only Android
 
 ## setImmediateValue
 
 Set immediate value in app.
 
-Appium: support only iOs
-not tested
+See corresponding [webdriverio reference](http://webdriver.io/api/mobile/setImmediateValue.html).
 
-```js
-I.setImmediateValue(el, 'foo')
-```
+Appium: support only iOS
 
 **Parameters**
 
--   `id` - ID of a WebElement JSON object to route the command to.
--   `value` - The sequence of keys to type. An array must be provided. The server should flatten the array items to a single string to be typed.
+-   `id`  
+-   `value`  
 
-## setOrientation
+## setNetworkConnection
 
-Set a device orientation. Will fail, if app will not change orientation
+Set network connection mode.
 
-Appium: support Android and iOS
+-   airplane mode
+-   wifi mode
+-   data data
 
 ```js
-I.setOrientation('landscape')
+I.setNetworkConnection(0) // airplane mode off, wifi off, data off
+I.setNetworkConnection(1) // airplane mode on, wifi off, data off
+I.setNetworkConnection(2) // airplane mode off, wifi on, data off
+I.setNetworkConnection(4) // airplane mode off, wifi off, data on
+I.setNetworkConnection(6) // airplane mode off, wifi on, data on
 ```
 
-**Parameters**
+See corresponding [webdriverio reference](http://webdriver.io/api/mobile/setNetworkConnection.html).
 
--   `orientation` - orientation (landscape/portrait)
+Appium: support only Android
 
-## setNetworkConnection
+**Parameters**
 
-Set network connection.
+-   `value`  
 
-Appium: support only Android
+## setOrientation
+
+Set a device orientation. Will fail, if app will not set orientation
 
 ```js
-I.setNetworkConnection(1)
+I.setOrientation('PORTRAIT');
+I.setOrientation('LANDSCAPE')
 ```
 
 **Parameters**
 
--   `value` - bitmasks of network connection. See http://webdriver.io/api/mobile/setNetworkConnection.html
+-   `orientation`  LANDSCAPE or PORTRAITAppium: support Android and iOS
 
 ## setSettings
 
 Update the current setting on the device
 
-Appium: support Android and iOS
-
 ```js
-I.setSettings({ cyberdelia: 'open' })
+I.setSettings({cyberdelia: 'open'});
 ```
 
 **Parameters**
 
--   `settings` - key/value pairs defining settings on the device
+-   `settings`  objectAppium: support Android and iOS
 
-## simulateTouchId
+## shakeDevice
 
- Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
+Perform a shake action on the device.
+
+```js
+I.shakeDevice();
+```
 
 Appium: support only iOS
-not tested
+
+## simulateTouchId
+
+Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
 
 ```js
-I.simulateTouchId(true)
+I.touchId(); // simulates valid fingerprint
+I.touchId(true); // simulates valid fingerprint
+I.touchId(false); // simulates invalid fingerprint
 ```
 
+Appium: support only iOS
+TODO: not tested
+
 **Parameters**
 
--   `match` - if true the command simulates a valid fingerprint
+-   `match`  
 
 ## startActivity
 
 Start an arbitrary Android activity during a session.
 
-Appium: support only Android
-
 ```js
-I.startActivity('io.appium.android.apis','.view.DragAndDropDemo')
+I.startActivity('io.selendroid.testapp', '.RegisterUserActivity');
 ```
 
-**Parameters**
+Appium: support only Android
 
--   `appPackage` - name of app
--   `appActivity` - name of activity
+**Parameters**
 
+-   `appPackage`  
+-   `appActivity`  
 
 ## swipe
 
 Perform a swipe on the screen or an element.
 
-Appium: support Android and iOS
-
 ```js
-I.swipe('//elem', 300, 200, 150);
+let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+I.swipe(locator, 800, 1200, 1000);
 ```
 
+[See complete reference](http://webdriver.io/api/mobile/swipe.html)
+
 **Parameters**
 
--   `locator` - element to swipe on
--   `xoffset` - x offset of swipe gesture (in pixels or relative units)
--   `yoffset` - y offset of swipe gesture (in pixels or relative units)
--   `speed` - time (in seconds) to spend performing the swipe
+-   `locator`  
+-   `xoffset`  
+-   `yoffset`  
+-   `speed`  Appium: support Android and iOS
 
 ## swipeDown
 
 Perform a swipe down on an element.
 
-Appium: support Android and iOS
-
 ```js
-I.swipeDown('//elem', 300, 200);
+let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+I.swipeDown(locator, 1200, 1000);
 ```
 
 **Parameters**
 
--   `locator` - element to swipe on
--   `yoffset` - y offset of swipe gesture (in pixels or relative units)
--   `speed` - time (in seconds) to spend performing the swipe
+-   `locator`  
+-   `yoffset`  (optional)
+-   `yOffset`  
+-   `speed`  Appium: support Android and iOS
 
 ## swipeLeft
 
 Perform a swipe left on an element.
 
-Appium: support Android and iOS
-
 ```js
-I.swipeDown('//elem', 300, 200);
+let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+I.swipeLeft(locator, 800, 1000);
 ```
 
 **Parameters**
 
--   `locator` - element to swipe on
--   `xoffset` - x offset of swipe gesture (in pixels or relative units)
--   `speed` - time (in seconds) to spend performing the swipe
+-   `locator`  
+-   `xoffset`  (optional)
+-   `speed`  Appium: support Android and iOS
 
 ## swipeRight
 
-Perform a swipe right on an element.
-
-Appium: support Android and iOS
+Perform a swipe left on an element.
 
 ```js
-I.swipeRight('//elem', 300, 200);
+let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+I.swipeRight(locator, 800, 1000);
 ```
 
 **Parameters**
 
--   `locator` - element to swipe on
--   `xoffset` - x offset of swipe gesture (in pixels or relative units)
--   `speed` - time (in seconds) to spend performing the swipe
+-   `locator`  
+-   `xoffset`  (optional)
+-   `speed`  Appium: support Android and iOS
 
 ## swipeTo
 
-Perform a swipe in selected direction on an element to seachable element.
-
-Appium: support Android and iOS
+Perform a swipe in selected direction on an element to searchable element.
 
 ```js
-I.swipeTo("//searchelem", "//elem", 'left', 30, 400, 100);
+I.swipeTo(
+ "android.widget.CheckBox", // searchable element
+ "//android.widget.ScrollView/android.widget.LinearLayout", // scroll element
+  "up", // direction
+   30,
+   100,
+   500);
 ```
 
 **Parameters**
 
--   `seachableLocator` - element to search
--   `scrollLocator` - element to swipe on
--   `direction` - direction to swipe ('down', 'up', 'left', 'right')
--   `timeout` - seconds to wait
--   `offset` - offset of swipe gesture (in pixels or relative units)
--   `speed` - time (in seconds) to spend performing the swipe
+-   `searchableLocator`  
+-   `scrollLocator`  
+-   `direction`  
+-   `timeout`  
+-   `offset`  
+-   `speed`  Appium: support Android and iOS
 
 ## swipeUp
 
-Perform a swipe right on an element.
-
-Appium: support Android and iOS
+Perform a swipe down on an element.
 
 ```js
-I.swipeUp('//elem', 300, 200);
+let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+I.swipeUp(locator, 1200, 1000);
 ```
 
 **Parameters**
 
--   `locator` - element to swipe on
--   `yoffset` - y offset of swipe gesture (in pixels or relative units)
--   `speed` - time (in seconds) to spend performing the swipe
-
+-   `locator`  
+-   `yoffset`  (optional)
+-   `yOffset`  
+-   `speed`  Appium: support Android and iOS
 
 ## switchToContext
 
-Switch to the specified context
-
-Appium: support only Android
+Switch to the specified context.
 
 ```js
-I.switchToContext('NATIVE_APP')
+I.switchToContext('WEBVIEW_io.selendroid.testapp');
 ```
 
 **Parameters**
 
--   `value` - name of context
-
+-   `context`  the context to switch toAppium: support only Android
 
 ## touchPerform
 
-Performs a specific touch action. The action object need to contain the action name, x/y coordinates
-
-Appium: support Android and iOS
+Performs a specific touch action.
+The action object need to contain the action name, x/y coordinates
 
 ```js
 I.touchPerform([{
     action: 'press',
     options: {
-        x: 100,
-        y: 250
+      x: 100,
+      y: 200
     }
+}, {action: 'release'}])
+
+I.touchPerform([{
+   action: 'tap',
+   options: {
+       element: '1', // json web element was queried before
+       x: 10,   // x offset
+       y: 20,   // y offset
+       count: 1 // number of touches
+   }
 }]);
 ```
 
+Appium: support Android and iOS
+
 **Parameters**
 
--   `actions` - touch action as object or object[] with attributes like touchCount, x, y, duration
+-   `actions`  
diff --git a/docs/helpers/WebDriverIO.md b/docs/helpers/WebDriverIO.md
index ee9b56e05..119058a56 100644
--- a/docs/helpers/WebDriverIO.md
+++ b/docs/helpers/WebDriverIO.md
@@ -1,13 +1,15 @@
 # WebDriverIO
 
 WebDriverIO helper which wraps [webdriverio](http://webdriver.io/) library to
-manipulate browser using Selenium WebDriver, PhantomJS.
+manipulate browser using Selenium WebDriver or PhantomJS.
 
 #### Selenium Installation
 
 1.  Download [Selenium Server](http://docs.seleniumhq.org/download/)
-2.  For Chrome browser install [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/getting-started), for Firefox browser install [GeckoDriver](https://github.com/mozilla/geckodriver).
-3.  Launch the server: `java -jar selenium-server-standalone-3.xx.xxx.jar`. To locate Chromedriver binary use `-Dwebdriver.chrome.driver=./chromedriver` option. For Geckodriver use `-Dwebdriver.gecko.driver=`.
+2.  For Chrome browser install [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/getting-started),
+    for Firefox browser install [GeckoDriver](https://github.com/mozilla/geckodriver).
+3.  Launch the server: `java -jar selenium-server-standalone-3.xx.xxx.jar`. To locate Chromedriver binary use
+    `-Dwebdriver.chrome.driver=./chromedriver` option. For Geckodriver use `-Dwebdriver.gecko.driver=`.
 
 #### PhantomJS Installation
 
@@ -19,9 +21,7 @@ It allows you to run Selenium tests on a server without a GUI installed.
 
 ### Configuration
 
-This helper should be configured in codecept.conf.js
-
-#### Desktop configuration
+This helper should be configured in codecept.json
 
 -   `url` - base url of website to be tested
 -   `browser` - browser in which perform testing
@@ -29,29 +29,33 @@ This helper should be configured in codecept.conf.js
 -   `keepCookies` (optional, default: false)  - keep cookies between tests when `restart` set to false.
 -   `windowSize`: (optional) default window size. Set to `maximize` or a dimension in the format `640x480`.
 -   `waitForTimeout`: (option) sets default wait time in _ms_ for all `wait*` functions. 1000 by default;
--   `desiredCapabilities`: Selenium's [desired capabilities](https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities)
--   `manualStart` (optional, default: false) - do not start browser before a test, start it manually inside a helper with `this.helpers["WebDriverIO"]._startBrowser()`
+-   `desiredCapabilities`: Selenium's [desired
+    capabilities](https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities)
+-   `manualStart` (optional, default: false) - do not start browser before a test, start it manually inside a helper
+    with `this.helpers["WebDriverIO"]._startBrowser()`
 -   `timeouts`: [WebDriverIO timeouts](http://webdriver.io/guide/testrunner/timeouts.html) defined as hash.
 
 Example:
 
-```js
+```json
 {
-   helpers: {
-     WebDriverIO : {
-       browser: "chrome",
-       restart: false,
-       windowSize: "maximize",
-       timeouts: {
-         script: 60000,
-         page load: 10000,
-         implicit : 5000       }
+   "helpers": {
+     "WebDriverIO" : {
+       "browser": "chrome",
+       "restart": false,
+       "windowSize": "maximize",
+       "timeouts": {
+         "script": 60000,
+         "page load": 10000,
+         "implicit" : 5000
+       }
      }
    }
 }
 ```
 
-Additional configuration params can be used from [webdriverio website](http://webdriver.io/guide/getstarted/configuration.html).
+Additional configuration params can be used from [webdriverio
+website](http://webdriver.io/guide/getstarted/configuration.html).
 
 ### Connect through proxy
 
@@ -60,19 +64,19 @@ need to update the `helpers.WebDriverIO.desiredCapabilities.proxy` key.
 
 ```js
 {
-    helpers: {
-        WebDriverIO: {
-            desiredCapabilities: {
-                proxy: {
-                    proxyType: "manual|pac",
-                    proxyAutoconfigUrl: "URL TO PAC FILE",
-                    httpProxy: "PROXY SERVER",
-                    sslProxy: "PROXY SERVER",
-                    ftpProxy: "PROXY SERVER",
-                    socksProxy: "PROXY SERVER",
-                    socksUsername: "USERNAME",
-                    socksPassword: "PASSWORD",
-                    noProxy: "BYPASS ADDRESSES"
+    "helpers": {
+        "WebDriverIO": {
+            "desiredCapabilities": {
+                "proxy": {
+                    "proxyType": "manual|pac",
+                    "proxyAutoconfigUrl": "URL TO PAC FILE",
+                    "httpProxy": "PROXY SERVER",
+                    "sslProxy": "PROXY SERVER",
+                    "ftpProxy": "PROXY SERVER",
+                    "socksProxy": "PROXY SERVER",
+                    "socksUsername": "USERNAME",
+                    "socksPassword": "PASSWORD",
+                    "noProxy": "BYPASS ADDRESSES"
                 }
             }
         }
@@ -84,15 +88,15 @@ For example,
 
 ```js
 {
-    helpers: {
-        WebDriverIO: {
-            desiredCapabilities: {
-                proxy: {
-                    proxyType: "manual",
-                    httpProxy: "http://corporate.proxy:8080",
-                    socksUsername: "codeceptjs",
-                    socksPassword: "secret",
-                    noProxy: "127.0.0.1,localhost"
+    "helpers": {
+        "WebDriverIO": {
+            "desiredCapabilities": {
+                "proxy": {
+                    "proxyType": "manual",
+                    "httpProxy": "http://corporate.proxy:8080",
+                    "socksUsername": "codeceptjs",
+                    "socksPassword": "secret",
+                    "noProxy": "127.0.0.1,localhost"
                 }
             }
         }
@@ -100,7 +104,8 @@ For example,
 }
 ```
 
-Please refer to [Selenium - Proxy Object](https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities) for more information.
+Please refer to [Selenium - Proxy Object](https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities) for more
+information.
 
 ### Cloud Providers
 
@@ -113,13 +118,13 @@ service provider to connect to.
 
 ```js
 {
-    helpers:{
-        WebDriverIO: {
-            url: "YOUR_DESIERED_HOST",
-            user: "YOUR_BROWSERSTACK_USER",
-            key: "YOUR_BROWSERSTACK_KEY",
-            desiredCapabilities: {
-                browserName: "chrome",
+    "helpers":{
+        "WebDriverIO": {
+            "url": "YOUR_DESIERED_HOST",
+            "user": "YOUR_BROWSERSTACK_USER",
+            "key": "YOUR_BROWSERSTACK_KEY",
+            "desiredCapabilities": {
+                "browserName": "chrome",
 
                 // only set this if you're using BrowserStackLocal to test a local domain
                 // "browserstack.local": true,
@@ -141,17 +146,17 @@ Here is the [webdriverio docs](http://webdriver.io/guide/usage/multiremote.html)
 
 ```js
 {
-    helpers: {
-        WebDriverIO: {
-            multiremote: {
-                MyChrome: {
-                    desiredCapabilities: {
-                        browserName: "chrome"
+    "helpers": {
+        "WebDriverIO": {
+            "multiremote": {
+                "MyChrome": {
+                    "desiredCapabilities": {
+                        "browserName": "chrome"
                      }
                 },
-                MyFirefox: {
-                   desiredCapabilities: {
-                       browserName: "firefox"
+                "MyFirefox": {
+                   "desiredCapabilities": {
+                       "browserName": "firefox"
                    }
                 }
             }
@@ -170,7 +175,7 @@ this.helpers['WebDriverIO'].browser
 
 **Parameters**
 
--   `config`
+-   `config`  
 
 ## _locate
 
@@ -224,7 +229,8 @@ this.helpers['WebDriverIO']._locateFields('Your email').then // ...
 ## acceptPopup
 
 Accepts the active JavaScript native popup window, as created by window.alert|window.confirm|window.prompt.
-Don't confuse popups with modal windows, as created by [various libraries](http://jster.net/category/windows-modals-popups).
+Don't confuse popups with modal windows, as created by [various
+libraries](http://jster.net/category/windows-modals-popups). Appium: support only web testing
 
 ## amOnPage
 
@@ -240,6 +246,7 @@ I.amOnPage('/login'); // opens a login page
 **Parameters**
 
 -   `url`  url path or global url
+    Appium: support only web testing
 
 ## appendField
 
@@ -254,6 +261,7 @@ I.appendField('#myTextField', 'appended');
 
 -   `field`  located by label|name|CSS|XPath|strict locator
 -   `value`  text value
+    Appium: support, but it's clear a field before insert in apps
 
 ## attachFile
 
@@ -269,11 +277,13 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 **Parameters**
 
 -   `locator`  field located by label|name|CSS|XPath|strict locator
--   `pathToFile`  local file path relative to codecept.json config file
+-   `pathToFile`  local file path relative to codecept.json config fileAppium: not tested
 
 ## cancelPopup
 
 Dismisses the active JavaScript popup, as created by window.alert|window.confirm|window.prompt.
+Appium: support only web testing
+
 ## checkOption
 
 Selects a checkbox or radio button.
@@ -291,6 +301,7 @@ I.checkOption('agree', '//form');
 
 -   `field`  checkbox located by label | name | CSS | XPath | strict locator
 -   `context`  (optional) element located by CSS | XPath | strict locator
+    Appium: not tested
 
 ## clearCookie
 
@@ -305,6 +316,7 @@ I.clearCookie('test');
 **Parameters**
 
 -   `cookie`  (optional)
+    Appium: support only web testing
 
 ## clearField
 
@@ -319,6 +331,7 @@ I.clearField('#email');
 **Parameters**
 
 -   `field`  located by label|name|CSS|XPath|strict locator
+    Appium: support
 
 ## click
 
@@ -348,11 +361,12 @@ I.click({css: 'nav a.login'});
 
 -   `locator`  clickable link or button located by text, or any element located by CSS|XPath|strict locator
 -   `context`  (optional) element to search in CSS|XPath|Strict locator
+    Appium: support
 
 ## defineTimeout
 
 Set [WebDriverIO timeouts](http://webdriver.io/guide/testrunner/timeouts.html) in realtime.
-
+Appium: support only web testing
 Timeouts are expected to be passed as object:
 
 ```js
@@ -377,6 +391,7 @@ I.dontSee('Login'); // assume we are already logged in
 
 -   `text`  is not present
 -   `context`  (optional) element located by CSS|XPath|strict locator in which to perfrom search
+    Appium: support with context in apps
 
 ## dontSeeCheckboxIsChecked
 
@@ -384,7 +399,7 @@ Verifies that the specified checkbox is not checked.
 
 **Parameters**
 
--   `field`  located by label|name|CSS|XPath|strict locator
+-   `field`  located by label|name|CSS|XPath|strict locatorAppium: not tested
 
 ## dontSeeCookie
 
@@ -392,7 +407,7 @@ Checks that cookie with given name does not exist.
 
 **Parameters**
 
--   `name`  
+-   `name`  Appium: support only web testing
 
 ## dontSeeCurrentUrlEquals
 
@@ -401,7 +416,7 @@ If a relative url provided, a configured url will be prepended to it.
 
 **Parameters**
 
--   `url`  
+-   `url`  Appium: support only web testing
 
 ## dontSeeElement
 
@@ -410,6 +425,7 @@ Opposite to `seeElement`. Checks that element is not visible
 **Parameters**
 
 -   `locator`  located by CSS|XPath|Strict locator
+    Appium: support
 
 ## dontSeeElementInDOM
 
@@ -418,6 +434,7 @@ Opposite to `seeElementInDOM`. Checks that element is not on page.
 **Parameters**
 
 -   `locator`  located by CSS|XPath|Strict locator
+    Appium: support
 
 ## dontSeeInCurrentUrl
 
@@ -425,7 +442,7 @@ Checks that current url does not contain a provided fragment.
 
 **Parameters**
 
--   `url`  
+-   `url`  Appium: support only web testing
 
 ## dontSeeInField
 
@@ -436,6 +453,7 @@ Opposite to `seeInField`.
 
 -   `field`  located by label|name|CSS|XPath|strict locator
 -   `value`  is not expected to be a field value
+    Appium: support only web testing
 
 ## dontSeeInSource
 
@@ -443,7 +461,7 @@ Checks that the current page contains the given string in its raw source code
 
 **Parameters**
 
--   `text`  
+-   `text`  Appium: support
 
 ## dontSeeInTitle
 
@@ -451,7 +469,7 @@ Checks that title does not contain text.
 
 **Parameters**
 
--   `text`  
+-   `text`  Appium: support only web testing
 
 ## doubleClick
 
@@ -468,11 +486,12 @@ I.doubleClick('.btn.edit');
 **Parameters**
 
 -   `locator`  
--   `context`  
+-   `context`  Appium: support only web testing
 
 ## dragAndDrop
 
 Drag an item to a destination element.
+Appium: not tested
 
 ```js
 I.dragAndDrop('#dragHandle', '#container');
@@ -559,7 +578,7 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 **Parameters**
 
 -   `field`  located by label|name|CSS|XPath|strict locator
--   `value`  
+-   `value`  Appium: support
 
 ## grabAttributeFrom
 
@@ -573,7 +592,7 @@ let hint = yield I.grabAttributeFrom('#tooltip', 'title');
 **Parameters**
 
 -   `locator`  element located by CSS|XPath|strict locator
--   `attr`  
+-   `attr`  Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
 
 ## grabCookie
 
@@ -587,12 +606,13 @@ assert(cookie.value, '123456');
 
 **Parameters**
 
--   `name`  
+-   `name`  Appium: support only web testing
 
 ## grabHTMLFrom
 
 Retrieves the innerHTML from an element located by CSS or XPath and returns it to test.
 Resumes test execution, so **should be used inside a generator with `yield`** operator.
+Appium: support only web testing
 
 ```js
 let postHTML = yield I.grabHTMLFrom('#post');
@@ -602,6 +622,18 @@ let postHTML = yield I.grabHTMLFrom('#post');
 
 -   `locator`  
 
+## grabSource
+
+Checks that the current page contains the given string in its raw source code.
+
+```js
+I.seeInSource('<h1>Green eggs &amp; ham</h1>');
+```
+
+**Parameters**
+
+-   `text`  Appium: support
+
 ## grabTextFrom
 
 Retrieves a text from an element located by CSS or XPath and returns it to test.
@@ -614,6 +646,7 @@ let pin = yield I.grabTextFrom('#pin');
 **Parameters**
 
 -   `locator`  element located by CSS|XPath|strict locator
+    Appium: support
 
 ## grabTitle
 
@@ -624,6 +657,8 @@ Resumes test execution, so **should be used inside a generator with `yield`** op
 let title = yield I.grabTitle();
 ```
 
+Appium: support only web testing
+
 ## grabValueFrom
 
 Retrieves a value from a form element located by CSS or XPath and returns it to test.
@@ -636,6 +671,7 @@ let email = yield I.grabValueFrom('input[name=email]');
 **Parameters**
 
 -   `locator`  field located by label|name|CSS|XPath|strict locator
+    Appium: support only web testing
 
 ## moveCursorTo
 
@@ -647,6 +683,8 @@ I.moveCursorTo('.tooltip');
 I.moveCursorTo('#submit', 5,5);
 ```
 
+Appium: support only web testing
+
 **Parameters**
 
 -   `locator`  
@@ -667,7 +705,8 @@ I.pressKey(['Control','a']);
 
 **Parameters**
 
--   `key`  To make combinations with modifier and mouse clicks (like Ctrl+Click) press a modifier, click, then release it.```js
+-   `key`  To make combinations with modifier and mouse clicks (like Ctrl+Click) press a modifier, click, then release it.
+    Appium: support, but clear field before pressing in apps```js
     I.pressKey('Control');
     I.click('#someelement');
     I.pressKey('Control');
@@ -681,11 +720,12 @@ First parameter can be set to `maximize`
 **Parameters**
 
 -   `width`  or `maximize`
--   `height`  
+-   `height`  Appium: not tested in web, in apps doesn't work
 
 ## rightClick
 
 Performs right click on an element matched by CSS or XPath.
+Appium: support, but in apps works as usual click
 
 **Parameters**
 
@@ -706,11 +746,13 @@ I.saveScreenshot('debug.png',true) \\resizes to available scrollHeight and scrol
 
 -   `fileName`  
 -   `fullPage`  (optional)
+    Appium: support
 
 ## scrollTo
 
 Scrolls to element matched by locator.
 Extra shift can be set with offsetX and offsetY options
+Appium: support only web testing
 
 ```js
 I.scrollTo('footer');
@@ -738,6 +780,7 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 -   `text`  expected on page
 -   `context`  (optional) element located by CSS|Xpath|strict locator in which to search for text
+    Appium: support with context in apps
 
 ## seeCheckboxIsChecked
 
@@ -752,6 +795,7 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 **Parameters**
 
 -   `field`  located by label|name|CSS|XPath|strict locator
+    Appium: not tested
 
 ## seeCookie
 
@@ -763,12 +807,11 @@ I.seeCookie('Auth');
 
 **Parameters**
 
--   `name`  
+-   `name`  Appium: support only web testing
 
 ## seeCurrentUrlEquals
 
 Checks that current url is equal to provided one.
-
 If a relative url provided, a configured url will be prepended to it.
 So both examples will work:
 
@@ -779,7 +822,7 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
 
 **Parameters**
 
--   `url`  
+-   `url`  Appium: support only web testing
 
 ## seeElement
 
@@ -793,6 +836,7 @@ I.seeElement('#modal');
 **Parameters**
 
 -   `locator`  located by CSS|XPath|strict locator
+    Appium: support
 
 ## seeElementInDOM
 
@@ -806,6 +850,7 @@ I.seeElementInDOM('#modal');
 **Parameters**
 
 -   `locator`  located by CSS|XPath|strict locator
+    Appium: support
 
 ## seeInCurrentUrl
 
@@ -817,7 +862,7 @@ I.seeInCurrentUrl('/register'); // we are on registration page
 
 **Parameters**
 
--   `url`  
+-   `url`  Appium: support only web testing
 
 ## seeInField
 
@@ -834,11 +879,12 @@ I.seeInField('#searchform input','Search');
 **Parameters**
 
 -   `field`  located by label|name|CSS|XPath|strict locator
--   `value`  
+-   `value`  Appium: support only web testing
 
 ## seeInPopup
 
-Checks that the active JavaScript popup, as created by `window.alert|window.confirm|window.prompt`, contains the given string.
+Checks that the active JavaScript popup, as created by `window.alert|window.confirm|window.prompt`, contains the
+given string. Appium: support only web testing
 
 **Parameters**
 
@@ -854,7 +900,7 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 
 **Parameters**
 
--   `text`  
+-   `text`  Appium: support
 
 ## seeInTitle
 
@@ -862,12 +908,13 @@ Checks that title contains text.
 
 **Parameters**
 
--   `text`  
+-   `text`  Appium: support only web testing
 
 ## seeNumberOfElements
 
 asserts that an element appears a given number of times in the DOM
 Element is located by label or name or CSS or XPath.
+Appium: support
 
 ```js
 I.seeNumberOfElements('#submitBtn', 1);
@@ -916,7 +963,7 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 **Parameters**
 
 -   `select`  field located by label|name|CSS|XPath|strict locator
--   `option`  
+-   `option`  Appium: support only web testing
 
 ## setCookie
 
@@ -928,11 +975,12 @@ I.setCookie({name: 'auth', value: true});
 
 **Parameters**
 
--   `cookie`  Uses Selenium's JSON [cookie format](https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object).
+-   `cookie`  Appium: support only web testingUses Selenium's JSON [cookie format](https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object).
 
 ## switchTo
 
 Switches frame or in case of null locator reverts to parent.
+Appium: support only web testing
 
 **Parameters**
 
@@ -948,7 +996,7 @@ I.wait(2); // wait 2 secs
 
 **Parameters**
 
--   `sec`  
+-   `sec`  Appium: support
 
 ## waitForElement
 
@@ -964,6 +1012,7 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 
 -   `locator`  element located by CSS|XPath|strict locator
 -   `sec`  time seconds to wait, 1 by default
+    Appium: support
 
 ## waitForEnabled
 
@@ -974,6 +1023,7 @@ Element can be located by CSS or XPath.
 
 -   `locator`  element located by CSS|XPath|strict locator
 -   `sec`  time seconds to wait, 1 by default
+    Appium: support
 
 ## waitForInvisible
 
@@ -985,7 +1035,7 @@ Element can be located by CSS or XPath.
 **Parameters**
 
 -   `locator`  element located by CSS|XPath|strict locator
--   `sec`  time seconds to wait, 1 by default
+-   `sec`  time seconds to wait, 1 by defaultAppium: support
 
 ## waitForStalenessOf
 
@@ -997,7 +1047,7 @@ Element can be located by CSS or XPath.
 **Parameters**
 
 -   `locator`  element located by CSS|XPath|strict locator
--   `sec`  time seconds to wait, 1 by default
+-   `sec`  time seconds to wait, 1 by defaultAppium: support
 
 ## waitForText
 
@@ -1015,6 +1065,7 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 -   `text`  to wait for
 -   `sec`  seconds to wait
 -   `context`  element located by CSS|XPath|strict locator
+    Appium: support
 
 ## waitForVisible
 
@@ -1027,11 +1078,13 @@ Element can be located by CSS or XPath.
 
 -   `locator`  element located by CSS|XPath|strict locator
 -   `sec`  time seconds to wait, 1 by default
+    Appium: support
 
 ## waitToHide
 
 Waits for an element to become invisible on a page (by default waits for 1sec).
 Element can be located by CSS or XPath.
+Appium: support
 
 **Parameters**
 
@@ -1041,8 +1094,9 @@ Element can be located by CSS or XPath.
 ## waitUntil
 
 Waits for a function to return true (waits for 1sec by default).
+Appium: support
 
 **Parameters**
 
 -   `fn`  
--   `sec`
+-   `sec`  
diff --git a/lib/helper/Appium.js b/lib/helper/Appium.js
index 99e474bec..ab9900974 100644
--- a/lib/helper/Appium.js
+++ b/lib/helper/Appium.js
@@ -12,15 +12,29 @@ const fs = require('fs');
 let browserCap;
 
 /**
- Appium helper is extends from WebriverIO. It's support all browser methods and also includes special methods for mobile apps testing. You can use this helper to test Web on desktop and mobile devices and mobile apps.
+ Appium helper extends [WebriverIO](http://codecept.io/helpers/WebDriverIO/) helper.
+ It supports all browser methods and also includes special methods for mobile apps testing.
+ You can use this helper to test Web on desktop and mobile devices and mobile apps.
+
  #### Appium Installation
+
  Appium is an open source test automation framework for use with native, hybrid and mobile web apps that implements the WebDriver protocol.
  It allows you to run Selenium tests on mobile devices and also test native, hybrid and mobile web apps.
- 1.  Download and install [Appium](http://appium.io/)
- 2.  Launch the daemon: `appium`
+
+ Download and install [Appium](http://appium.io/)
+
+ ```
+ npm install -g appium
+ ```
+
+ Launch the daemon: `appium`
+
  ### Configuration
+
  This helper should be configured in codecept.conf.js
+
  #### Appium configuration
+
  -   `port`: Appium serverport
  -   `restart`: restart browser or app between tests (default: true), if set to false cookies will be cleaned but browser window will be kept and for apps nothing will be changed.
  -   `desiredCapabilities`: Appium capabilities
@@ -31,7 +45,9 @@ let browserCap;
  --   `platformVersion`: Mobile OS version
  --   `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
  --   `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
+
  Example:
+
  ```js
  {
    helpers: {
@@ -49,11 +65,15 @@ let browserCap;
     }
  }
  ```
+
  Additional configuration params can be used from <https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md>
+
  ## Access From Helpers
+
  Receive a Appium client from a custom helper by accessing `browser` property:
+
  ```js
- this.helpers['Appium'].browser
+ let browser = this.helpers['Appium'].browser
  ```
  */
 class Appium extends WebdriverIO {
@@ -125,6 +145,13 @@ class Appium extends WebdriverIO {
 
   /**
    * Check if an app is installed.
+   *
+   * ```js
+   * I.seeAppIsInstalled("com.example.android.apis");
+   * ```
+   *
+   * @param bundleId	String	ID of bundled app
+   *
    * Appium: support only Android
    */
   seeAppIsInstalled(bundleId) {
@@ -136,6 +163,13 @@ class Appium extends WebdriverIO {
 
   /**
    * Check if an app is not installed.
+   *
+   * ```js
+   * I.seeAppIsNotInstalled("com.example.android.apis");
+   * ```
+   *
+   * @param bundleId	String	ID of bundled app
+   *
    * Appium: support only Android
    */
   seeAppIsNotInstalled(bundleId) {
@@ -147,6 +181,12 @@ class Appium extends WebdriverIO {
 
   /**
    * Install an app on device.
+   *
+   * ```js
+   * I.installApp('/path/to/file.apk');
+   * ```
+   * @param path path to apk file
+   *
    * Appium: support only Android
    */
   installApp(path) {
@@ -156,6 +196,12 @@ class Appium extends WebdriverIO {
 
   /**
    * Remove an app from the device.
+   *
+   * ```js
+   * I.removeApp('com.example.android.apis');
+   * ```
+   * @param bundleId	String	ID of bundled app
+   *
    * Appium: support only Android
    */
   removeApp(bundleId) {
@@ -164,7 +210,12 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * check current activity on an Android device.
+   * Check current activity on an Android device.
+   *
+   * ```js
+   * I.seeCurrentActivityIs(".HomeScreenActivity")
+   * ```
+   *
    * Appium: support only Android
    */
   seeCurrentActivityIs(currentActivity) {
@@ -176,6 +227,11 @@ class Appium extends WebdriverIO {
 
   /**
    * Check whether the device is locked.
+   *
+   * ```js
+   * I.seeDeviceIsLocked();
+   * ```
+   *
    * Appium: support only Android
    */
   seeDeviceIsLocked() {
@@ -187,9 +243,14 @@ class Appium extends WebdriverIO {
 
   /**
    * Check whether the device is not locked.
+   *
+   * ```js
+   * I.seeDeviceIsUnlocked();
+   * ```
+   *
    * Appium: support only Android
    */
-  dontSeeDeviceIsLocked() {
+  seeDeviceIsUnlocked() {
     onlyForApps.call(this, "Android");
     return this.browser.isLocked().then(function (res) {
       return truth('device', 'to be locked').negate(res.value);
@@ -198,6 +259,14 @@ class Appium extends WebdriverIO {
 
   /**
    * Check the device orientation
+   *
+   * ```js
+   * I.seeOrientationIs('PORTRAIT');
+   * I.seeOrientationIs('LANDSCAPE')
+   * ```
+   *
+   * @param orientation LANDSCAPE or PORTRAIT
+   *
    * Appium: support Android and iOS
    */
   seeOrientationIs(orientation) {
@@ -209,6 +278,14 @@ class Appium extends WebdriverIO {
 
   /**
    * Set a device orientation. Will fail, if app will not set orientation
+   *
+   * ```js
+   * I.setOrientation('PORTRAIT');
+   * I.setOrientation('LANDSCAPE')
+   * ```
+   *
+   * @param orientation LANDSCAPE or PORTRAIT
+   *
    * Appium: support Android and iOS
    */
   setOrientation(orientation) {
@@ -218,6 +295,11 @@ class Appium extends WebdriverIO {
 
   /**
    * Get list of all available contexts
+   *
+   * ```
+   * let contexts = yield I.grabAllContexts();
+   * ```
+   *
    * Appium: support Android and iOS
    */
   grabAllContexts() {
@@ -229,6 +311,11 @@ class Appium extends WebdriverIO {
 
   /**
    * Retrieve current context
+   *
+   * ```js
+   * let context = yield I.grabContext();
+   * ```
+   *
    * Appium: support Android and iOS
    */
   grabContext() {
@@ -240,6 +327,11 @@ class Appium extends WebdriverIO {
 
   /**
    * Get current device activity.
+   *
+   * ```js
+   * let activity = yield I.grabCurrentActivity();
+   * ```
+   *
    * Appium: support only Android
    */
   grabCurrentActivity() {
@@ -248,9 +340,14 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Get informations about the current network connection (Data/WIFI/Airplane).
+   * Get information about the current network connection (Data/WIFI/Airplane).
    * The actual server value will be a number. However WebdriverIO additional
    * properties to the response object to allow easier assertions.
+   *
+   * ```js
+   * let con = yield I.grabNetworkConnection();
+   * ```
+   *
    * Appium: support only Android
    */
   grabNetworkConnection() {
@@ -267,6 +364,11 @@ class Appium extends WebdriverIO {
 
   /**
    * Get current orientation.
+   *
+   * ```js
+   * let orientation = yield I.grabOrientation();
+   * ```
+   *
    * Appium: support Android and iOS
    */
   grabOrientation() {
@@ -277,7 +379,12 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Get all the currently specified settings
+   * Get all the currently specified settings.
+   *
+   * ```js
+   * let settings = yield I.grabSettings();
+   * ```
+   *
    * Appium: support Android and iOS
    */
   grabSettings() {
@@ -288,16 +395,28 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Switch to the specified context
+   * Switch to the specified context.
+   *
+   * ```js
+   * I.switchToContext('WEBVIEW_io.selendroid.testapp');
+   * ```
+   *
+   * @param context the context to switch to
+   *
    * Appium: support only Android
    */
-  switchToContext(value) {
+  switchToContext(context) {
     onlyForApps.call(this, "Android");
-    return this.browser.context(value);
+    return this.browser.context(context);
   }
 
   /**
    * Start an arbitrary Android activity during a session.
+   *
+   * ```js
+   * I.startActivity('io.selendroid.testapp', '.RegisterUserActivity');
+   * ```
+   *
    * Appium: support only Android
    */
   startActivity(appPackage, appActivity) {
@@ -306,7 +425,21 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Set network connection.
+   * Set network connection mode.
+   *
+   * * airplane mode
+   * * wifi mode
+   * * data data
+   *
+   * ```js
+   * I.setNetworkConnection(0) // airplane mode off, wifi off, data off
+   * I.setNetworkConnection(1) // airplane mode on, wifi off, data off
+   * I.setNetworkConnection(2) // airplane mode off, wifi on, data off
+   * I.setNetworkConnection(4) // airplane mode off, wifi off, data on
+   * I.setNetworkConnection(6) // airplane mode off, wifi on, data on
+   * ```
+   * See corresponding [webdriverio reference](http://webdriver.io/api/mobile/setNetworkConnection.html).
+   *
    * Appium: support only Android
    */
   setNetworkConnection(value) {
@@ -316,6 +449,13 @@ class Appium extends WebdriverIO {
 
   /**
    * Update the current setting on the device
+   *
+   * ```js
+   * I.setSettings({cyberdelia: 'open'});
+   * ```
+   *
+   * @param settings object
+   *
    * Appium: support Android and iOS
    */
   setSettings(settings) {
@@ -325,6 +465,18 @@ class Appium extends WebdriverIO {
 
   /**
    * Hide the keyboard.
+   *
+   * ```js
+   * // taps outside to hide keyboard per default
+   * I.hideDeviceKeyboard();
+   * I.hideDeviceKeyboard('tapOutside');
+   *
+   * // or by pressing key
+   * I.hideDeviceKeyboard('pressKey', 'Done');
+   * ```
+   *
+   * @param	strategy	desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)
+   *
    * Appium: support Android and iOS
    */
   hideDeviceKeyboard(strategy, key) {
@@ -334,9 +486,16 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * send a key event to the device
+   * Send a key event to the device.
+   * List of keys: https://developer.android.com/reference/android/view/KeyEvent.html
+   *
+   * ```js
+   * I.sendDeviceKeyEvent(3);
+   * ```
+   *
+   * @param keyValue	Device specifc key value
+   *
    * Appium: support only Android
-   * list of keys: https://developer.android.com/reference/android/view/KeyEvent.html
    */
   sendDeviceKeyEvent(keyValue) {
     onlyForApps.call(this, "Android");
@@ -345,6 +504,11 @@ class Appium extends WebdriverIO {
 
   /**
    * Open the notifications panel on the device.
+   *
+   * ```js
+   * I.openNotifications();
+   * ```
+   *
    * Appium: support only Android
    */
   openNotifications() {
@@ -357,7 +521,12 @@ class Appium extends WebdriverIO {
    * automated in Appium. At its core is the ability to chain together ad hoc
    * individual actions, which will then be applied to an element in the
    * application on the device.
-   * Full documentation http://webdriver.io/api/mobile/touchAction.html
+   * [See complete documentation](http://webdriver.io/api/mobile/touchAction.html)
+   *
+   * ```js
+   * I.makeTouchAction("~buttonStartWebviewCD", 'tap');
+   * ```
+   *
    * Appium: support Android and iOS
    */
   makeTouchAction(locator, action) {
@@ -367,6 +536,19 @@ class Appium extends WebdriverIO {
 
   /**
    * Perform a swipe on the screen or an element.
+   *
+   * ```js
+   * let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+   * I.swipe(locator, 800, 1200, 1000);
+   * ```
+   *
+   * [See complete reference](http://webdriver.io/api/mobile/swipe.html)
+   *
+   * @param locator
+   * @param xoffset
+   * @param yoffset
+   * @param speed
+   *
    * Appium: support Android and iOS
    */
   swipe(locator, xoffset, yoffset, speed) {
@@ -376,6 +558,16 @@ class Appium extends WebdriverIO {
 
   /**
    * Perform a swipe down on an element.
+   *
+   * ```js
+   * let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+   * I.swipeDown(locator, 1200, 1000);
+   * ```
+   *
+   * @param locator
+   * @param yoffset (optional)
+   * @param speed
+   *
    * Appium: support Android and iOS
    */
   swipeDown(locator, yOffset, speed) {
@@ -385,6 +577,16 @@ class Appium extends WebdriverIO {
 
   /**
    * Perform a swipe left on an element.
+   *
+   * ```js
+   * let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+   * I.swipeLeft(locator, 800, 1000);
+   * ```
+   *
+   * @param locator
+   * @param xoffset (optional)
+   * @param speed
+   *
    * Appium: support Android and iOS
    */
   swipeLeft(locator, xoffset, speed) {
@@ -393,7 +595,17 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Perform a swipe right on an element.
+   * Perform a swipe left on an element.
+   *
+   * ```js
+   * let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+   * I.swipeRight(locator, 800, 1000);
+   * ```
+   *
+   * @param locator
+   * @param xoffset (optional)
+   * @param speed
+   *
    * Appium: support Android and iOS
    */
   swipeRight(locator, xoffset, speed) {
@@ -402,7 +614,17 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Perform a swipe up on an element.
+   * Perform a swipe down on an element.
+   *
+   * ```js
+   * let locator = "//android.widget.LinearLayout[@resource-id = 'io.selendroid.testapp:id/LinearLayout1']";
+   * I.swipeUp(locator, 1200, 1000);
+   * ```
+   *
+   * @param locator
+   * @param yoffset (optional)
+   * @param speed
+   *
    * Appium: support Android and iOS
    */
   swipeUp(locator, yOffset, speed) {
@@ -411,10 +633,28 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Perform a swipe in selected direction on an element to seachable element.
+   * Perform a swipe in selected direction on an element to searchable element.
+   *
+   * ```js
+   * I.swipeTo(
+   *  "android.widget.CheckBox", // searchable element
+   *  "//android.widget.ScrollView/android.widget.LinearLayout", // scroll element
+   *   "up", // direction
+   *    30,
+   *    100,
+   *    500);
+   * ```
+   *
+   * @param searchableLocator
+   * @param scrollLocator
+   * @param direction
+   * @param timeout
+   * @param offset
+   * @param speed
+   *
    * Appium: support Android and iOS
    */
-  swipeTo(seachableLocator, scrollLocator, direction, timeout, offset, speed) {
+  swipeTo(searchableLocator, scrollLocator, direction, timeout, offset, speed) {
     onlyForApps.call(this);
     direction = direction || 'down';
     switch (direction) {
@@ -433,7 +673,7 @@ class Appium extends WebdriverIO {
     }
     timeout = timeout || this.options.waitForTimeout;
 
-    var errorMsg = 'element ("' + seachableLocator + '") still not visible after ' + timeout + 'seconds';
+    var errorMsg = 'element ("' + searchableLocator + '") still not visible after ' + timeout + 'seconds';
     let browser = this.browser;
     let err = false;
     let currentSource;
@@ -441,7 +681,7 @@ class Appium extends WebdriverIO {
       if (err) {
         return new Error('Scroll to the end and element ' + seachableLocator + ' was not found');
       } else {
-        return browser.isVisible(withStrictLocator(seachableLocator))
+        return browser.isVisible(withStrictLocator(searchableLocator))
           .then(function (res) {
             if (res) {
               return true;
@@ -469,7 +709,29 @@ class Appium extends WebdriverIO {
   }
 
   /**
-   * Performs a specific touch action. The action object need to contain the action name, x/y coordinates
+   * Performs a specific touch action.
+   * The action object need to contain the action name, x/y coordinates
+   *
+   * ```js
+   * I.touchPerform([{
+   *     action: 'press',
+   *     options: {
+   *       x: 100,
+   *       y: 200
+   *     }
+   * }, {action: 'release'}])
+   *
+   * I.touchPerform([{
+   *    action: 'tap',
+   *    options: {
+   *        element: '1', // json web element was queried before
+   *        x: 10,   // x offset
+   *        y: 20,   // y offset
+   *        count: 1 // number of touches
+   *    }
+   * }]);
+   * ```
+   *
    * Appium: support Android and iOS
    */
   touchPerform(actions) {
@@ -479,6 +741,13 @@ class Appium extends WebdriverIO {
 
   /**
    * Pulls a file from the device.
+   *
+   * ```js
+   * I.pullFile('/storage/emulated/0/DCIM/logo.png', 'my/path');
+   * // save file to output dir
+   * I.pullFile('/storage/emulated/0/DCIM/logo.png', output_dir);
+   * ```
+   *
    * Appium: support Android and iOS
    */
   pullFile(path, dest) {
@@ -495,17 +764,28 @@ class Appium extends WebdriverIO {
 
   /**
    * Perform a shake action on the device.
+   *
+   * ```js
+   * I.shakeDevice();
+   * ```
+   *
    * Appium: support only iOS
    */
-  makeShake() {
+  shakeDevice() {
     onlyForApps.call(this, "iOS");
     return this.browser.shake();
   }
 
   /**
    * Perform a rotation gesture centered on the specified element.
+   *
+   * ```js
+   * I.rotate(120, 120)
+   * ```
+   *
+   * See corresponding [webdriverio reference](http://webdriver.io/api/mobile/rotate.html).
+   *
    * Appium: support only iOS
-   TODO: not tested
    */
   rotate(x, y, duration, radius, rotation, touchCount) {
     onlyForApps.call(this, "iOS");
@@ -514,8 +794,10 @@ class Appium extends WebdriverIO {
 
   /**
    * Set immediate value in app.
+   *
+   * See corresponding [webdriverio reference](http://webdriver.io/api/mobile/setImmediateValue.html).
+   *
    * Appium: support only iOS
-   TODO: not tested
    */
   setImmediateValue(id, value) {
     onlyForApps.call(this, "iOS");
@@ -524,17 +806,29 @@ class Appium extends WebdriverIO {
 
   /**
    * Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
+   *
+   * ```js
+   * I.touchId(); // simulates valid fingerprint
+   * I.touchId(true); // simulates valid fingerprint
+   * I.touchId(false); // simulates invalid fingerprint
+   * ```
+   *
    * Appium: support only iOS
    * TODO: not tested
    */
   simulateTouchId(match) {
     onlyForApps.call(this, "iOS");
     match = match || true;
-    return this.browser.touch(match);
+    return this.browser.touchId(match);
   }
 
   /**
    * Close the given application.
+   *
+   * ```js
+   * I.closeApp();
+   * ```
+   *
    * Appium: support only iOS
    */
   closeApp() {
@@ -542,10 +836,6 @@ class Appium extends WebdriverIO {
     return this.browser.closeApp();
   }
 
-  /*
-   * End Appium Methods
-   */
-
 }
 
 function isCSSorXPathLocator(locator) {
diff --git a/test/helper/Appium_test.js b/test/helper/Appium_test.js
index 63f7efbff..a9979954d 100644
--- a/test/helper/Appium_test.js
+++ b/test/helper/Appium_test.js
@@ -133,10 +133,10 @@ describe('Appium', function () {
     });
   });
 
-  describe('device lock : #seeDeviceIsLocked, #dontSeeDeviceIsLocked', () => {
+  describe('device lock : #seeDeviceIsLocked, #seeDeviceIsUnlocked', () => {
 
     it('should return correct status about lock', () => {
-      return app.dontSeeDeviceIsLocked()
+      return app.seeDeviceIsUnlocked()
         .then(() => app.seeDeviceIsLocked())
         .then(expectError)
         .catch((e) => {

From 4232cfe467c8c9a2e8e60ca1590e5cfa01e088ae Mon Sep 17 00:00:00 2001
From: Davert <davert.php@resend.cc>
Date: Sun, 4 Jun 2017 02:10:36 +0300
Subject: [PATCH 2/2] added inherited docs

---
 docs/helpers/Appium.md | 284 +++++++++++++++++++++++++++++++++++++----
 lib/helper/Appium.js   | 279 +++++++++++++++++++++++++++++++---------
 2 files changed, 475 insertions(+), 88 deletions(-)

diff --git a/docs/helpers/Appium.md b/docs/helpers/Appium.md
index 99cc56237..ae936c9ae 100644
--- a/docs/helpers/Appium.md
+++ b/docs/helpers/Appium.md
@@ -1,8 +1,8 @@
 # Appium
 
 Appium helper extends [WebriverIO](http://codecept.io/helpers/WebDriverIO/) helper.
-It supports all browser methods and also includes special methods for mobile apps testing.
-You can use this helper to test Web on desktop and mobile devices and mobile apps.
+ It supports all browser methods and also includes special methods for mobile apps testing.
+ You can use this helper to test Web on desktop and mobile devices and mobile apps.
 
 #### Appium Installation
 
@@ -17,38 +17,38 @@ Launch the daemon: `appium`
 
 ### Configuration
 
-This helper should be configured in codecept.conf.js
+This helper should be configured in codecept.json or codecept.conf.js
 
 #### Appium configuration
 
--   `port`: Appium serverport
+-   `port`: Appium port
 -   `restart`: restart browser or app between tests (default: true), if set to false cookies will be cleaned but browser window will be kept and for apps nothing will be changed.
--   `desiredCapabilities`: Appium capabilities
-    --   `platformName` - Which mobile OS platform to use
-    --   `appPackage` - Java package of the Android app you want to run
-    --   `appActivity` - Activity name for the Android activity you want to launch from your package.
-    --   `deviceName`: The kind of mobile device or emulator to use
-    --   `platformVersion`: Mobile OS version
-    --   `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
-    --   `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
+-   `desiredCapabilities`: [], Appium capabilities, see below
+    -   `platformName` - Which mobile OS platform to use
+    -   `appPackage` - Java package of the Android app you want to run
+    -   `appActivity` - Activity name for the Android activity you want to launch from your package.
+    -   `deviceName`: The kind of mobile device or emulator to use
+    -   `platformVersion`: Mobile OS version
+    -   `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
+    -   `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
 
 Example:
 
 ```js
 {
-helpers: {
-WebDriverIO: {
-desiredCapabilities: {
-platformName: "Android",
-appPackage: "com.example.android.myApp",
-appActivity: "MainActivity",
-deviceName: "OnePlus3",
-platformVersion: "6.0.1"
-},
-port: 4723,
-restart: false
-}
-}
+  helpers: {
+      WebDriverIO: {
+          desiredCapabilities: {
+              platformName: "Android",
+              appPackage: "com.example.android.myApp",
+              appActivity: "MainActivity",
+              deviceName: "OnePlus3",
+              platformVersion: "6.0.1"
+          },
+          port: 4723,
+          restart: false
+      }
+    }
 }
 ```
 
@@ -586,3 +586,237 @@ Appium: support Android and iOS
 **Parameters**
 
 -   `actions`  
+
+## appendField
+
+Appends text to a input field or textarea.
+Field is located by name, label, CSS or XPath
+
+```js
+I.appendField('#myTextField', 'appended');
+```
+
+**Parameters**
+
+-   `field`  located by label|name|CSS|XPath|strict locator
+-   `value`  text value
+
+## checkOption
+
+Selects a checkbox or radio button.
+Element is located by label or name or CSS or XPath.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
+
+```js
+I.checkOption('#agree');
+I.checkOption('I Agree to Terms and Conditions');
+I.checkOption('agree', '//form');
+```
+
+**Parameters**
+
+-   `field`  checkbox located by label | name | CSS | XPath | strict locator
+-   `context`  (optional) element located by CSS | XPath | strict locator
+
+## click
+
+Perform a click on a link or a button, given by a locator.
+If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+For images, the "alt" attribute and inner text of any parent links are searched.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
+
+```js
+// simple link
+I.click('Logout');
+// button of form
+I.click('Submit');
+// CSS button
+I.click('#form input[type=submit]');
+// XPath
+I.click('//form/*[@type=submit]');
+// link in context
+I.click('Logout', '#nav');
+// using strict locator
+I.click({css: 'nav a.login'});
+```
+
+**Parameters**
+
+-   `locator`  clickable link or button located by text, or any element located by CSS|XPath|strict locator
+-   `context`  (optional) element to search in CSS|XPath|Strict locator
+
+## dontSee
+
+Opposite to `see`. Checks that a text is not present on a page.
+Use context parameter to narrow down the search.
+
+```js
+I.dontSee('Login'); // assume we are already logged in
+```
+
+**Parameters**
+
+-   `text`  is not present
+-   `context`  (optional) element located by CSS|XPath|strict locator in which to perfrom search
+
+## dontSeeCheckboxIsChecked
+
+Verifies that the specified checkbox is not checked.
+
+**Parameters**
+
+-   `field`  located by label|name|CSS|XPath|strict locator
+
+## dontSeeElement
+
+Opposite to `seeElement`. Checks that element is not visible
+
+**Parameters**
+
+-   `locator`  located by CSS|XPath|Strict locator
+
+## dontSeeInField
+
+Checks that value of input field or textare doesn't equal to given value
+Opposite to `seeInField`.
+
+**Parameters**
+
+-   `field`  located by label|name|CSS|XPath|strict locator
+-   `value`  is not expected to be a field value
+
+## fillField
+
+Fills a text field or textarea, after clearing its value, with the given string.
+Field is located by name, label, CSS, or XPath.
+
+```js
+// by label
+I.fillField('Email', 'hello@world.com');
+// by name
+I.fillField('password', '123456');
+// by CSS
+I.fillField('form#login input[name=username]', 'John');
+// or by strict locator
+I.fillField({css: 'form#login input[name=username]'}, 'John');
+```
+
+**Parameters**
+
+-   `field`  located by label|name|CSS|XPath|strict locator
+-   `value`  
+
+## grabTextFrom
+
+Retrieves a text from an element located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside a generator with `yield`** operator.
+
+```js
+let pin = yield I.grabTextFrom('#pin');
+```
+
+**Parameters**
+
+-   `locator`  element located by CSS|XPath|strict locator
+
+## grabValueFrom
+
+Retrieves a value from a form element located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside a generator with `yield`** operator.
+
+```js
+let email = yield I.grabValueFrom('input[name=email]');
+```
+
+**Parameters**
+
+-   `locator`  field located by label|name|CSS|XPath|strict locator
+
+## see
+
+Checks that a page contains a visible text.
+Use context parameter to narrow down the search.
+
+```js
+I.see('Welcome'); // text welcome on a page
+I.see('Welcome', '.content'); // text inside .content div
+I.see('Register', {css: 'form.register'}); // use strict locator
+```
+
+**Parameters**
+
+-   `text`  expected on page
+-   `context`  (optional) element located by CSS|Xpath|strict locator in which to search for text
+
+## seeCheckboxIsChecked
+
+Verifies that the specified checkbox is checked.
+
+```js
+I.seeCheckboxIsChecked('Agree');
+I.seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms
+I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
+```
+
+**Parameters**
+
+-   `field`  located by label|name|CSS|XPath|strict locator
+
+## seeElement
+
+Checks that a given Element is visible
+Element is located by CSS or XPath.
+
+```js
+I.seeElement('#modal');
+```
+
+**Parameters**
+
+-   `locator`  located by CSS|XPath|strict locator
+
+## seeInField
+
+Checks that the given input field or textarea equals to given value.
+For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
+
+```js
+I.seeInField('Username', 'davert');
+I.seeInField({css: 'form textarea'},'Type your comment here');
+I.seeInField('form input[type=hidden]','hidden_value');
+I.seeInField('#searchform input','Search');
+```
+
+**Parameters**
+
+-   `field`  located by label|name|CSS|XPath|strict locator
+-   `value`  
+
+# selectOption
+
+Selects an option in a drop-down select.
+Field is searched by label | name | CSS | XPath.
+Option is selected by visible text or by value.
+
+```js
+I.selectOption('Choose Plan', 'Monthly'); // select by label
+I.selectOption('subscription', 'Monthly'); // match option by text
+I.selectOption('subscription', '0'); // or by value
+I.selectOption('//form/select[@name=account]','Premium');
+I.selectOption('form select[name=account]', 'Premium');
+I.selectOption({css: 'form select[name=account]'}, 'Premium');
+```
+
+Provide an array for the second argument to select multiple options.
+
+```js
+I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+```
+
+**Parameters**
+
+-   `select`  field located by label|name|CSS|XPath|strict locator
+-   `option`  
diff --git a/lib/helper/Appium.js b/lib/helper/Appium.js
index ab9900974..8d4162165 100644
--- a/lib/helper/Appium.js
+++ b/lib/helper/Appium.js
@@ -12,69 +12,69 @@ const fs = require('fs');
 let browserCap;
 
 /**
- Appium helper extends [WebriverIO](http://codecept.io/helpers/WebDriverIO/) helper.
- It supports all browser methods and also includes special methods for mobile apps testing.
- You can use this helper to test Web on desktop and mobile devices and mobile apps.
-
- #### Appium Installation
-
- Appium is an open source test automation framework for use with native, hybrid and mobile web apps that implements the WebDriver protocol.
- It allows you to run Selenium tests on mobile devices and also test native, hybrid and mobile web apps.
-
- Download and install [Appium](http://appium.io/)
-
- ```
- npm install -g appium
- ```
-
- Launch the daemon: `appium`
-
- ### Configuration
-
- This helper should be configured in codecept.conf.js
-
- #### Appium configuration
-
- -   `port`: Appium serverport
- -   `restart`: restart browser or app between tests (default: true), if set to false cookies will be cleaned but browser window will be kept and for apps nothing will be changed.
- -   `desiredCapabilities`: Appium capabilities
- --   `platformName` - Which mobile OS platform to use
- --   `appPackage` - Java package of the Android app you want to run
- --   `appActivity` - Activity name for the Android activity you want to launch from your package.
- --   `deviceName`: The kind of mobile device or emulator to use
- --   `platformVersion`: Mobile OS version
- --   `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
- --   `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
-
- Example:
-
- ```js
- {
-   helpers: {
-       WebDriverIO: {
-           desiredCapabilities: {
-               platformName: "Android",
-               appPackage: "com.example.android.myApp",
-               appActivity: "MainActivity",
-               deviceName: "OnePlus3",
-               platformVersion: "6.0.1"
-           },
-           port: 4723,
-           restart: false
-       }
-    }
- }
- ```
-
- Additional configuration params can be used from <https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md>
-
- ## Access From Helpers
-
- Receive a Appium client from a custom helper by accessing `browser` property:
-
- ```js
- let browser = this.helpers['Appium'].browser
- ```
+ *  Appium helper extends [WebriverIO](http://codecept.io/helpers/WebDriverIO/) helper.
+ *  It supports all browser methods and also includes special methods for mobile apps testing.
+ *  You can use this helper to test Web on desktop and mobile devices and mobile apps.
+ *
+ * #### Appium Installation
+ *
+ * Appium is an open source test automation framework for use with native, hybrid and mobile web apps that implements the WebDriver protocol.
+ * It allows you to run Selenium tests on mobile devices and also test native, hybrid and mobile web apps.
+ *
+ * Download and install [Appium](http://appium.io/)
+ *
+ * ```
+ * npm install -g appium
+ * ```
+ *
+ * Launch the daemon: `appium`
+ *
+ * ### Configuration
+ *
+ * This helper should be configured in codecept.json or codecept.conf.js
+ *
+ * #### Appium configuration
+ *
+ * * `port`: Appium port
+ * * `restart`: restart browser or app between tests (default: true), if set to false cookies will be cleaned but browser window will be kept and for apps nothing will be changed.
+ * * `desiredCapabilities`: [], Appium capabilities, see below
+ *     * `platformName` - Which mobile OS platform to use
+ *     * `appPackage` - Java package of the Android app you want to run
+ *     * `appActivity` - Activity name for the Android activity you want to launch from your package.
+ *     * `deviceName`: The kind of mobile device or emulator to use
+ *     * `platformVersion`: Mobile OS version
+ *     * `app` - The absolute local path or remote http URL to an .ipa or .apk file, or a .zip containing one of these. Appium will attempt to install this app binary on the appropriate device first.
+ *     * `browserName`: Name of mobile web browser to automate. Should be an empty string if automating an app instead.
+ *
+ * Example:
+ *
+ * ```js
+ * {
+ *   helpers: {
+ *       WebDriverIO: {
+ *           desiredCapabilities: {
+ *               platformName: "Android",
+ *               appPackage: "com.example.android.myApp",
+ *               appActivity: "MainActivity",
+ *               deviceName: "OnePlus3",
+ *               platformVersion: "6.0.1"
+ *           },
+ *           port: 4723,
+ *           restart: false
+ *       }
+ *     }
+ * }
+ * ```
+ *
+ * Additional configuration params can be used from <https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md>
+ *
+ * ## Access From Helpers
+ *
+ * Receive a Appium client from a custom helper by accessing `browser` property:
+ *
+ * ```js
+ * let browser = this.helpers['Appium'].browser
+ * ```
  */
 class Appium extends WebdriverIO {
 
@@ -901,3 +901,156 @@ function onlyForApps(platformName) {
 
 
 module.exports = Appium;
+
+// docs for inherited methods
+
+/**
+ * {{> ../webapi/appendField }}
+ *
+ * @name appendField
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _appendField;
+
+/**
+ * {{> ../webapi/checkOption }}
+ *
+ * @name checkOption
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _checkOption;
+
+/**
+ * {{> ../webapi/click }}
+ *
+ * @name click
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _click;
+
+/**
+ * {{> ../webapi/dontSeeCheckboxIsChecked }}
+ *
+ * @name dontSeeCheckboxIsChecked
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _dontSeeCheckboxIsChecked;
+
+/**
+ * {{> ../webapi/dontSeeElement }}
+ *
+ * @name dontSeeElement
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _dontSeeElement;
+
+/**
+ * {{> ../webapi/dontSeeInField }}
+ *
+ * @name dontSeeInField
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _dontSeeInField;
+
+
+/**
+ * {{> ../webapi/dontSee }}
+ *
+ * @name dontSee
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _dontSee;
+
+/**
+ * {{> ../webapi/fillField }}
+ *
+ * @name fillField
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _fillField;
+
+/**
+ * {{> ../webapi/grabTextFrom }}
+ *
+ * @name grabTextFrom
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _grabTextFrom;
+
+/**
+ * {{> ../webapi/grabValueFrom }}
+ *
+ * @name grabValueFrom
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _grabValueFrom;
+
+/**
+ * {{> ../webapi/seeCheckboxIsChecked }}
+ *
+ * @name seeCheckboxIsChecked
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _seeCheckboxIsChecked;
+
+/**
+ * {{> ../webapi/seeElement }}
+ *
+ * @name seeElement
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _seeElement;
+
+/**
+ * {{> ../webapi/seeInField }}
+ *
+ * @name seeInField
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _seeInField;
+
+/**
+ * {{> ../webapi/see }}
+ *
+ * @name see
+ * @kind function
+ * @memberof Appium
+ * @scope instance
+ */
+var _see;
+
+/**
+ * {{> ../webapi/selectOption }}
+ *
+ * @name selectOption
+ * @kind function
+ * @memberof Protractor
+ * @scope instance
+ */
+var _selectOption;