Update docs for find_element/s (#531)

* update find_element/s

* add some examples

* update migration

Author: KazuCocoa

docs/docs.md

@@ -51,7 +51,7 @@ Appium::Driver.new(caps: apk).start_driver
 
 Example use of Appium's mobile gesture.
 
-> @driver.find_element()
+> @driver.find_element_with_appium()
 
 `console.rb` uses some code from [simple_test.rb](
 https://github.com/appium/appium/blob/82995f47408530c80c3376f4e07a1f649d96ba22/sample-code/examples/ruby/simple_test.rb) and is released under the [same license](https://github.com/appium/appium/blob/c58eeb66f2d6fa3b9a89d188a2e657cca7cb300f/LICENSE) as Appium. The [Accessibility Inspector](https://developer.apple.com/library/ios/#documentation/UserExperience/Conceptual/iPhoneAccessibility/Testing_Accessibility/Testing_Accessibility.html) is helpful for discovering button names and textfield values.

docs/migration.md

@@ -1,3 +1,25 @@
+### Breaking Changes in 9.1.0
+change `@selenium_driver.find_element/s` to `@selenium_driver.find_element/s_with_appium`.
+ref: https://github.com/appium/ruby_lib/pull/383
+
+           Old | New
+            :--|:--
+`@selenium_driver.find_element/s` | `@selenium_driver.find_element/s_with_appium`
+
+- after
+
+```
+@selenium_driver.find_element_with_appium :accessibility_id, "some ids"
+@selenium_driver.find_elements_with_appium :accessibility_id, "some ids"
+```
+
+- before
+
+```
+@selenium_driver.find_element :accessibility_id, "some ids"
+@selenium_driver.find_elements :accessibility_id, "some ids"
+```
+
 ### Breaking Changes in 8.2.0
 change `Appium.load_appium_txt` to `Appium.load_settings`.
 

lib/appium_lib/device/device.rb

@@ -423,10 +423,10 @@ def create_bridge_command(method)
         end
       end
 
-      # @!method find_element
-      # @!method find_elements
+      # @!method find_element_with_appium
+      # @!method find_elements_with_appium
       #
-      #   find_element/s with their accessibility_id
+      #   find_element/s_with_appium with their accessibility_id
       #
       #   ```ruby
       #    find_elements :accessibility_id, 'Animation'

lib/appium_lib/driver.rb

@@ -688,15 +688,29 @@ def execute_script(script, *args)
       @driver.execute_script script, *args
     end
 
-    # Calls @driver.find_elements
+    # Calls @driver.find_elements_with_appium
+    #
+    # ```
+    # @driver = Appium::Driver.new()
+    # @driver.find_elements :predicate, yyy
+    # ```
+    #
+    # If you call `Appium.promote_appium_methods`, you can call `find_elements` directly.
     #
     # @param [*args] args The args to use
     # @return [Array<Element>] Array is empty when no elements are found.
     def find_elements(*args)
       @driver.find_elements_with_appium(*args)
     end
 
-    # Calls @driver.find_elements
+    # Calls @driver.find_element_with_appium
+    #
+    # ```
+    # @driver = Appium::Driver.new()
+    # @driver.find_element :accessibility_id, zzz
+    # ```
+    #
+    # If you call `Appium.promote_appium_methods`, you can call `find_element` directly.
     #
     # @param [*args] args The args to use
     # @return [Element]