docs(webdriver): protractor style docs for getDriver, getId, and click (#3101)

Author: cnishina

lib/selenium-webdriver/webdriver.js

@@ -71,12 +71,38 @@ webdriver.WebElement = function(driver, id) {};
 goog.inherits(webdriver.WebElement, webdriver.Serializable);
 
 /**
+ * Gets the parent web element of this web element.
+ *
+ * @view
+ * <ul class="pet">
+ *  <li class="dog">Dog</li>
+ *  <li class="cat">Cat</li>
+ * </ul>
+ *
+ * @example
+ * // Using getDriver to find the parent web element to find the cat li
+ * var liDog = element(by.css('.dog')).getWebElement();
+ * var liCat = liDog.getDriver().findElement(by.css('.cat'));
+ *
  * @return {!webdriver.WebDriver} The parent driver for this instance.
  */
 webdriver.WebElement.prototype.getDriver = function() {};
 
 
 /**
+ * Gets the WebDriver ID string representation for this web element.
+ *
+ * @view
+ * <ul class="pet">
+ *   <li class="dog">Dog</li>
+ *   <li class="cat">Cat</li>
+ * </ul>
+ *
+ * @example
+ * // returns the dog web element
+ * var dog = element(by.css('.dog')).getWebElement();
+ * expect(dog.getId()).not.toBe(undefined);
+ *
  * @return {!webdriver.promise.Promise.<webdriver.WebElement.Id>} A promise
  *     that resolves to this element's JSON representation as defined by the
  *     WebDriver wire protocol.
@@ -115,6 +141,17 @@ webdriver.WebElement.prototype.findElement = function(subLocator) {};
 
 /**
  * Schedules a command to click on this element.
+ *
+ * @view
+ * <ul>
+ *   <li><a href="https://en.wikipedia.org/wiki/Doge_(meme)">Doge meme</a></li>
+ *   <li>Cat</li>
+ * </ul>
+ *
+ * @example
+ * // Clicks on the web link
+ * element(by.partialLinkText('Doge')).click();
+ *
  * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
  *     when the click command has completed.
  */
@@ -183,7 +220,7 @@ webdriver.WebElement.prototype.sendKeys = function(var_args) {};
  * @view
  * <span>{{person.name}}</span>
  *
- * @example 
+ * @example
  * expect(element(by.binding('person.name')).getTagName()).toBe('span');
  *
  * @return {!webdriver.promise.Promise.<string>} A promise that will be
@@ -204,7 +241,7 @@ webdriver.WebElement.prototype.getTagName = function() {};
  * @view
  * <span style='color: #000000'>{{person.name}}</span>
  *
- * @example 
+ * @example
  * expect(element(by.binding('person.name')).getCssValue().indexOf(
  *   'color: #000000')).not.toBe(-1);
  *