From 353349551e130eb8ef8836de2e3e4e445c1ecf39 Mon Sep 17 00:00:00 2001
From: Sajjad Hossain <sajjad@adcade.com>
Date: Sun, 5 Apr 2015 22:32:16 -0400
Subject: [PATCH 1/4] added example snippets in MinkExtenstion to be used with
 'vendor/bin/behat -di' as definitions

---
 .../MinkExtension/Context/MinkContext.php     | 165 ++++++++++++++++++
 1 file changed, 165 insertions(+)

diff --git a/src/Behat/MinkExtension/Context/MinkContext.php b/src/Behat/MinkExtension/Context/MinkContext.php
index 90ea0380..1109111c 100644
--- a/src/Behat/MinkExtension/Context/MinkContext.php
+++ b/src/Behat/MinkExtension/Context/MinkContext.php
@@ -26,6 +26,11 @@ class MinkContext extends RawMinkContext implements TranslatableContext
      *
      * @Given /^(?:|I )am on (?:|the )homepage$/
      * @When /^(?:|I )go to (?:|the )homepage$/
+     *
+     * Example: Given I am on the homepage
+     * Example: And I am on the homepage
+     * Example: When I go to the homepage
+     *
      */
     public function iAmOnHomepage()
     {
@@ -37,6 +42,11 @@ public function iAmOnHomepage()
      *
      * @Given /^(?:|I )am on "(?P<page>[^"]+)"$/
      * @When /^(?:|I )go to "(?P<page>[^"]+)"$/
+     *
+     * Example: Given I am on "/articles/isBatmanBruceWayne"
+     * Example: And I am on "/articles/isBatmanBruceWayne"
+     * Example: When I go to "/articles/isBatmanBruceWayne"
+     *
      */
     public function visit($page)
     {
@@ -47,6 +57,10 @@ public function visit($page)
      * Reloads current page.
      *
      * @When /^(?:|I )reload the page$/
+     *
+     * Example: And I relod the page
+     * Example: When I reload the page
+     *
      */
     public function reload()
     {
@@ -57,6 +71,10 @@ public function reload()
      * Moves backward one page in history.
      *
      * @When /^(?:|I )move backward one page$/
+     *
+     * Example: And I move backward one page
+     * Example: When I move backward one page
+     *
      */
     public function back()
     {
@@ -67,6 +85,10 @@ public function back()
      * Moves forward one page in history
      *
      * @When /^(?:|I )move forward one page$/
+     *
+     * Example: And I move forward one page
+     * Example: When I move forward one page
+     *
      */
     public function forward()
     {
@@ -77,6 +99,10 @@ public function forward()
      * Presses button with specified id|name|title|alt|value.
      *
      * @When /^(?:|I )press "(?P<button>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I press "Log In"
+     * Example: When I press "sign-in"
+     *
      */
     public function pressButton($button)
     {
@@ -88,6 +114,10 @@ public function pressButton($button)
      * Clicks link with specified id|title|alt|text.
      *
      * @When /^(?:|I )follow "(?P<link>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I follow "Log In"
+     * Example: When I follow "sign-in"
+     *
      */
     public function clickLink($link)
     {
@@ -101,6 +131,14 @@ public function clickLink($link)
      * @When /^(?:|I )fill in "(?P<field>(?:[^"]|\\")*)" with "(?P<value>(?:[^"]|\\")*)"$/
      * @When /^(?:|I )fill in "(?P<field>(?:[^"]|\\")*)" with:$/
      * @When /^(?:|I )fill in "(?P<value>(?:[^"]|\\")*)" for "(?P<field>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I fill in "username" with "bruceWayne"
+     * Example: And I fill in "username" with: bruceWayne
+     * Example: And I fill in "bruceWayne" for "username"
+     * Example: When I fill in "username" with "bruceWayne"
+     * Example: When I fill in "username" with: bruceWayne
+     * Example: When I fill in "bruceWayne" for "username"
+     *
      */
     public function fillField($field, $value)
     {
@@ -113,6 +151,16 @@ public function fillField($field, $value)
      * Fills in form fields with provided table.
      *
      * @When /^(?:|I )fill in the following:$/
+     *
+     * Example: And I fill in the following:
+     *              | userId | 27 |
+     *              | username | bruceWayne |
+     *              | password | iLoveBats123 |
+     * Example: When I follow "sign-in"
+     *              | userId | 27 |
+     *              | username | bruceWayne |
+     *              | password | iLoveBats123 |
+     *
      */
     public function fillFields(TableNode $fields)
     {
@@ -125,6 +173,10 @@ public function fillFields(TableNode $fields)
      * Selects option in select field with specified id|name|label|value.
      *
      * @When /^(?:|I )select "(?P<option>(?:[^"]|\\")*)" from "(?P<select>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I select "male" from "gender"
+     * Example: When I select "VISA" from "paymentType"
+     *
      */
     public function selectOption($select, $option)
     {
@@ -137,6 +189,10 @@ public function selectOption($select, $option)
      * Selects additional option in select field with specified id|name|label|value.
      *
      * @When /^(?:|I )additionally select "(?P<option>(?:[^"]|\\")*)" from "(?P<select>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I additionally select "female" from "gender"
+     * Example: When I additionally select "AMEX" from "paymentType"
+     *
      */
     public function additionallySelectOption($select, $option)
     {
@@ -149,6 +205,10 @@ public function additionallySelectOption($select, $option)
      * Checks checkbox with specified id|name|label|value.
      *
      * @When /^(?:|I )check "(?P<option>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I check "Mac OS X" from "os"
+     * Example: When I check "Batman" from "heroes"
+     *
      */
     public function checkOption($option)
     {
@@ -160,6 +220,10 @@ public function checkOption($option)
      * Unchecks checkbox with specified id|name|label|value.
      *
      * @When /^(?:|I )uncheck "(?P<option>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I uncheck "Mac OS X" from "os"
+     * Example: When I uncheck "Batman" from "heroes"
+     *
      */
     public function uncheckOption($option)
     {
@@ -171,6 +235,10 @@ public function uncheckOption($option)
      * Attaches file to field with specified id|name|label|value.
      *
      * @When /^(?:|I )attach the file "(?P<path>[^"]*)" to "(?P<field>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I check "Mac OS X" from "os"
+     * Example: When I check "Batman" from "heroes"
+     *
      */
     public function attachFileToField($field, $path)
     {
@@ -190,6 +258,10 @@ public function attachFileToField($field, $path)
      * Checks, that current page PATH is equal to specified.
      *
      * @Then /^(?:|I )should be on "(?P<page>[^"]+)"$/
+     *
+     * Example: And I should be on "/heroes/Batman"
+     * Example: Then I should be on "/heroes/Batman"
+     *
      */
     public function assertPageAddress($page)
     {
@@ -200,6 +272,10 @@ public function assertPageAddress($page)
      * Checks, that current page is the homepage.
      *
      * @Then /^(?:|I )should be on (?:|the )homepage$/
+     *
+     * Example: And I should be on the homepage
+     * Example: Then I should be on the hompage
+     *
      */
     public function assertHomepage()
     {
@@ -210,6 +286,10 @@ public function assertHomepage()
      * Checks, that current page PATH matches regular expression.
      *
      * @Then /^the (?i)url(?-i) should match (?P<pattern>"(?:[^"]|\\")*")$/
+     *
+     * Example: And the url should match "/heroes/\w+"
+     * Example: Then the url should match "/heroes/\w+"
+     *
      */
     public function assertUrlRegExp($pattern)
     {
@@ -220,6 +300,10 @@ public function assertUrlRegExp($pattern)
      * Checks, that current page response status is equal to specified.
      *
      * @Then /^the response status code should be (?P<code>\d+)$/
+     *
+     * Example: And the url should match "/heroes/\w+"
+     * Example: Then the url should match "/heroes/\w+"
+     *
      */
     public function assertResponseStatus($code)
     {
@@ -230,6 +314,10 @@ public function assertResponseStatus($code)
      * Checks, that current page response status is not equal to specified.
      *
      * @Then /^the response status code should not be (?P<code>\d+)$/
+     *
+     * Example: And the response status code should not be 404
+     * Example: Then the response status code should not be 404
+     *
      */
     public function assertResponseStatusIsNot($code)
     {
@@ -240,6 +328,10 @@ public function assertResponseStatusIsNot($code)
      * Checks, that page contains specified text.
      *
      * @Then /^(?:|I )should see "(?P<text>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I should see "This just in, Bruce Wayne is not Batman"
+     * Example: Then I should see "This just in, Bruce Wayne is not Batman"
+     *
      */
     public function assertPageContainsText($text)
     {
@@ -250,6 +342,10 @@ public function assertPageContainsText($text)
      * Checks, that page doesn't contain specified text.
      *
      * @Then /^(?:|I )should not see "(?P<text>(?:[^"]|\\")*)"$/
+     *
+     * Example: And I should not see "This just in, Bruce Wayne is Batman"
+     * Example: Then I should not see "This just in, Bruce Wayne is Batman"
+     *
      */
     public function assertPageNotContainsText($text)
     {
@@ -260,6 +356,10 @@ public function assertPageNotContainsText($text)
      * Checks, that page contains text matching specified pattern.
      *
      * @Then /^(?:|I )should see text matching (?P<pattern>"(?:[^"]|\\")*")$/
+     *
+     * Example: And I should not see "This just in, Bruce Wayne is Batman"
+     * Example: Then I should not see "This just in, Bruce Wayne is Batman"
+     *
      */
     public function assertPageMatchesText($pattern)
     {
@@ -270,6 +370,10 @@ public function assertPageMatchesText($pattern)
      * Checks, that page doesn't contain text matching specified pattern.
      *
      * @Then /^(?:|I )should not see text matching (?P<pattern>"(?:[^"]|\\")*")$/
+     *
+     * Example: And I should not see text matching "Bruce Wayne is Batman"
+     * Example: Then I should not see text matching "Bruce Wayne is Batman"
+     *
      */
     public function assertPageNotMatchesText($pattern)
     {
@@ -280,6 +384,10 @@ public function assertPageNotMatchesText($pattern)
      * Checks, that HTML response contains specified string.
      *
      * @Then /^the response should contain "(?P<text>(?:[^"]|\\")*)"$/
+     *
+     * Example: And the response should contain "<noscript>Sorry turn JavaScript on to view full experience</noscript>"
+     * Example: Then the response should contain "<noscript>Sorry turn JavaScript on to view full experience</noscript>"
+     *
      */
     public function assertResponseContains($text)
     {
@@ -290,6 +398,10 @@ public function assertResponseContains($text)
      * Checks, that HTML response doesn't contain specified string.
      *
      * @Then /^the response should not contain "(?P<text>(?:[^"]|\\")*)"$/
+     *
+     * Example: And the response should not contain "v1.0.1"
+     * Example: Then the response should not contain "v1.0.1"
+     *
      */
     public function assertResponseNotContains($text)
     {
@@ -300,6 +412,10 @@ public function assertResponseNotContains($text)
      * Checks, that element with specified CSS contains specified text.
      *
      * @Then /^(?:|I )should see "(?P<text>(?:[^"]|\\")*)" in the "(?P<element>[^"]*)" element$/
+     *
+     * Example: And I should see "Batman is dead?" in the "headline" element
+     * Example: Then I should see "Batman is dead?" in the "headline" element
+     *
      */
     public function assertElementContainsText($element, $text)
     {
@@ -310,6 +426,10 @@ public function assertElementContainsText($element, $text)
      * Checks, that element with specified CSS doesn't contain specified text.
      *
      * @Then /^(?:|I )should not see "(?P<text>(?:[^"]|\\")*)" in the "(?P<element>[^"]*)" element$/
+     *
+     * Example: And I should not see "Batman is alive?" in the "headline" element
+     * Example: Then I should not see "Batman is alive?" in the "headline" element
+     *
      */
     public function assertElementNotContainsText($element, $text)
     {
@@ -320,6 +440,10 @@ public function assertElementNotContainsText($element, $text)
      * Checks, that element with specified CSS contains specified HTML.
      *
      * @Then /^the "(?P<element>[^"]*)" element should contain "(?P<value>(?:[^"]|\\")*)"$/
+     *
+     * Example: And the "nav" element should contain "profile"
+     * Example: Then the "nav" element should contain "profile"
+     *
      */
     public function assertElementContains($element, $value)
     {
@@ -330,6 +454,10 @@ public function assertElementContains($element, $value)
      * Checks, that element with specified CSS doesn't contain specified HTML.
      *
      * @Then /^the "(?P<element>[^"]*)" element should not contain "(?P<value>(?:[^"]|\\")*)"$/
+     *
+     * Example: And the "nav" element should not contain "logged-in"
+     * Example: Then the "nav" element should not contain "logged-in"
+     *
      */
     public function assertElementNotContains($element, $value)
     {
@@ -340,6 +468,10 @@ public function assertElementNotContains($element, $value)
      * Checks, that element with specified CSS exists on page.
      *
      * @Then /^(?:|I )should see an? "(?P<element>[^"]*)" element$/
+     *
+     * Example: And I should see a "canvas" element
+     * Example: Then I should see an "apples" element
+     *
      */
     public function assertElementOnPage($element)
     {
@@ -350,6 +482,10 @@ public function assertElementOnPage($element)
      * Checks, that element with specified CSS doesn't exist on page.
      *
      * @Then /^(?:|I )should not see an? "(?P<element>[^"]*)" element$/
+     *
+     * Example: And I should not see a "canvas" element
+     * Example: Then I should not see an "apples" element
+     *
      */
     public function assertElementNotOnPage($element)
     {
@@ -360,6 +496,10 @@ public function assertElementNotOnPage($element)
      * Checks, that form field with specified id|name|label|value has specified value.
      *
      * @Then /^the "(?P<field>(?:[^"]|\\")*)" field should contain "(?P<value>(?:[^"]|\\")*)"$/
+     *
+     * Example: And the "name" field should contain "Bruce Wayne"
+     * Example: Then the "name" field should contain "Bruce Wayne"
+     *
      */
     public function assertFieldContains($field, $value)
     {
@@ -372,6 +512,10 @@ public function assertFieldContains($field, $value)
      * Checks, that form field with specified id|name|label|value doesn't have specified value.
      *
      * @Then /^the "(?P<field>(?:[^"]|\\")*)" field should not contain "(?P<value>(?:[^"]|\\")*)"$/
+     *
+     * Example: And the "name" field should not contain "Bruce Wayne"
+     * Example: Then the "name" field should not contain "Bruce Wayne"
+     *
      */
     public function assertFieldNotContains($field, $value)
     {
@@ -385,6 +529,10 @@ public function assertFieldNotContains($field, $value)
      *
      * @Then /^the "(?P<checkbox>(?:[^"]|\\")*)" checkbox should be checked$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" (?:is|should be) checked$/
+     *
+     * Example: And the "heroes" checkbox should be checked
+     * Example: Then the "heroes" checkbox is checked
+     *
      */
     public function assertCheckboxChecked($checkbox)
     {
@@ -397,6 +545,10 @@ public function assertCheckboxChecked($checkbox)
      * @Then /^the "(?P<checkbox>(?:[^"]|\\")*)" checkbox should not be checked$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" should (?:be unchecked|not be checked)$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" is (?:unchecked|not checked)$/
+     *
+     * Example: And the "villains" checkbox should be unchecked
+     * Example: Then the "villains" checkbox is not checked
+     *
      */
     public function assertCheckboxNotChecked($checkbox)
     {
@@ -407,6 +559,10 @@ public function assertCheckboxNotChecked($checkbox)
      * Checks, that (?P<num>\d+) CSS elements exist on the page
      *
      * @Then /^(?:|I )should see (?P<num>\d+) "(?P<element>[^"]*)" elements?$/
+     *
+     * Example: And I should see 5 "div" elements
+     * Example: Then I should see 5 "div" elements
+     *
      */
     public function assertNumElements($num, $element)
     {
@@ -417,6 +573,9 @@ public function assertNumElements($num, $element)
      * Prints current URL to console.
      *
      * @Then /^print current URL$/
+     *
+     * Example: Then print current URL
+     *
      */
     public function printCurrentUrl()
     {
@@ -427,6 +586,9 @@ public function printCurrentUrl()
      * Prints last response to console.
      *
      * @Then /^print last response$/
+     *
+     * Example: Then print last response
+     *
      */
     public function printLastResponse()
     {
@@ -440,6 +602,9 @@ public function printLastResponse()
      * Opens last response content in browser.
      *
      * @Then /^show last response$/
+     *
+     * Example: Then show last responsecd
+     *
      */
     public function showLastResponse()
     {

From 981c7f6650f256a7cab77313f612690347ce3d08 Mon Sep 17 00:00:00 2001
From: Sajjad Hossain <sajjad@adcade.com>
Date: Sun, 5 Apr 2015 22:48:44 -0400
Subject: [PATCH 2/4] another pull request, containing same step definition via
 'vendor/bin/behat -di'

---
 .../MinkExtension/Context/MinkContext.php     | 116 +-----------------
 1 file changed, 1 insertion(+), 115 deletions(-)

diff --git a/src/Behat/MinkExtension/Context/MinkContext.php b/src/Behat/MinkExtension/Context/MinkContext.php
index 1109111c..c0750c94 100644
--- a/src/Behat/MinkExtension/Context/MinkContext.php
+++ b/src/Behat/MinkExtension/Context/MinkContext.php
@@ -23,14 +23,11 @@ class MinkContext extends RawMinkContext implements TranslatableContext
 {
     /**
      * Opens homepage.
-     *
      * @Given /^(?:|I )am on (?:|the )homepage$/
      * @When /^(?:|I )go to (?:|the )homepage$/
-     *
      * Example: Given I am on the homepage
      * Example: And I am on the homepage
      * Example: When I go to the homepage
-     *
      */
     public function iAmOnHomepage()
     {
@@ -39,14 +36,11 @@ public function iAmOnHomepage()
 
     /**
      * Opens specified page.
-     *
      * @Given /^(?:|I )am on "(?P<page>[^"]+)"$/
      * @When /^(?:|I )go to "(?P<page>[^"]+)"$/
-     *
      * Example: Given I am on "/articles/isBatmanBruceWayne"
      * Example: And I am on "/articles/isBatmanBruceWayne"
      * Example: When I go to "/articles/isBatmanBruceWayne"
-     *
      */
     public function visit($page)
     {
@@ -55,9 +49,7 @@ public function visit($page)
 
     /**
      * Reloads current page.
-     *
      * @When /^(?:|I )reload the page$/
-     *
      * Example: And I relod the page
      * Example: When I reload the page
      *
@@ -69,12 +61,9 @@ public function reload()
 
     /**
      * Moves backward one page in history.
-     *
      * @When /^(?:|I )move backward one page$/
-     *
      * Example: And I move backward one page
      * Example: When I move backward one page
-     *
      */
     public function back()
     {
@@ -83,12 +72,9 @@ public function back()
 
     /**
      * Moves forward one page in history
-     *
      * @When /^(?:|I )move forward one page$/
-     *
      * Example: And I move forward one page
      * Example: When I move forward one page
-     *
      */
     public function forward()
     {
@@ -97,12 +83,9 @@ public function forward()
 
     /**
      * Presses button with specified id|name|title|alt|value.
-     *
      * @When /^(?:|I )press "(?P<button>(?:[^"]|\\")*)"$/
-     *
      * Example: And I press "Log In"
      * Example: When I press "sign-in"
-     *
      */
     public function pressButton($button)
     {
@@ -112,12 +95,9 @@ public function pressButton($button)
 
     /**
      * Clicks link with specified id|title|alt|text.
-     *
      * @When /^(?:|I )follow "(?P<link>(?:[^"]|\\")*)"$/
-     *
      * Example: And I follow "Log In"
      * Example: When I follow "sign-in"
-     *
      */
     public function clickLink($link)
     {
@@ -127,18 +107,15 @@ public function clickLink($link)
 
     /**
      * Fills in form field with specified id|name|label|value.
-     *
      * @When /^(?:|I )fill in "(?P<field>(?:[^"]|\\")*)" with "(?P<value>(?:[^"]|\\")*)"$/
      * @When /^(?:|I )fill in "(?P<field>(?:[^"]|\\")*)" with:$/
      * @When /^(?:|I )fill in "(?P<value>(?:[^"]|\\")*)" for "(?P<field>(?:[^"]|\\")*)"$/
-     *
      * Example: And I fill in "username" with "bruceWayne"
      * Example: And I fill in "username" with: bruceWayne
      * Example: And I fill in "bruceWayne" for "username"
      * Example: When I fill in "username" with "bruceWayne"
      * Example: When I fill in "username" with: bruceWayne
      * Example: When I fill in "bruceWayne" for "username"
-     *
      */
     public function fillField($field, $value)
     {
@@ -149,9 +126,7 @@ public function fillField($field, $value)
 
     /**
      * Fills in form fields with provided table.
-     *
      * @When /^(?:|I )fill in the following:$/
-     *
      * Example: And I fill in the following:
      *              | userId | 27 |
      *              | username | bruceWayne |
@@ -171,12 +146,9 @@ public function fillFields(TableNode $fields)
 
     /**
      * Selects option in select field with specified id|name|label|value.
-     *
      * @When /^(?:|I )select "(?P<option>(?:[^"]|\\")*)" from "(?P<select>(?:[^"]|\\")*)"$/
-     *
      * Example: And I select "male" from "gender"
      * Example: When I select "VISA" from "paymentType"
-     *
      */
     public function selectOption($select, $option)
     {
@@ -187,12 +159,9 @@ public function selectOption($select, $option)
 
     /**
      * Selects additional option in select field with specified id|name|label|value.
-     *
      * @When /^(?:|I )additionally select "(?P<option>(?:[^"]|\\")*)" from "(?P<select>(?:[^"]|\\")*)"$/
-     *
      * Example: And I additionally select "female" from "gender"
      * Example: When I additionally select "AMEX" from "paymentType"
-     *
      */
     public function additionallySelectOption($select, $option)
     {
@@ -203,9 +172,7 @@ public function additionallySelectOption($select, $option)
 
     /**
      * Checks checkbox with specified id|name|label|value.
-     *
      * @When /^(?:|I )check "(?P<option>(?:[^"]|\\")*)"$/
-     *
      * Example: And I check "Mac OS X" from "os"
      * Example: When I check "Batman" from "heroes"
      *
@@ -218,12 +185,9 @@ public function checkOption($option)
 
     /**
      * Unchecks checkbox with specified id|name|label|value.
-     *
      * @When /^(?:|I )uncheck "(?P<option>(?:[^"]|\\")*)"$/
-     *
      * Example: And I uncheck "Mac OS X" from "os"
      * Example: When I uncheck "Batman" from "heroes"
-     *
      */
     public function uncheckOption($option)
     {
@@ -233,12 +197,9 @@ public function uncheckOption($option)
 
     /**
      * Attaches file to field with specified id|name|label|value.
-     *
      * @When /^(?:|I )attach the file "(?P<path>[^"]*)" to "(?P<field>(?:[^"]|\\")*)"$/
-     *
      * Example: And I check "Mac OS X" from "os"
      * Example: When I check "Batman" from "heroes"
-     *
      */
     public function attachFileToField($field, $path)
     {
@@ -256,12 +217,9 @@ public function attachFileToField($field, $path)
 
     /**
      * Checks, that current page PATH is equal to specified.
-     *
      * @Then /^(?:|I )should be on "(?P<page>[^"]+)"$/
-     *
      * Example: And I should be on "/heroes/Batman"
      * Example: Then I should be on "/heroes/Batman"
-     *
      */
     public function assertPageAddress($page)
     {
@@ -270,12 +228,9 @@ public function assertPageAddress($page)
 
     /**
      * Checks, that current page is the homepage.
-     *
      * @Then /^(?:|I )should be on (?:|the )homepage$/
-     *
      * Example: And I should be on the homepage
      * Example: Then I should be on the hompage
-     *
      */
     public function assertHomepage()
     {
@@ -284,12 +239,9 @@ public function assertHomepage()
 
     /**
      * Checks, that current page PATH matches regular expression.
-     *
      * @Then /^the (?i)url(?-i) should match (?P<pattern>"(?:[^"]|\\")*")$/
-     *
      * Example: And the url should match "/heroes/\w+"
      * Example: Then the url should match "/heroes/\w+"
-     *
      */
     public function assertUrlRegExp($pattern)
     {
@@ -298,12 +250,9 @@ public function assertUrlRegExp($pattern)
 
     /**
      * Checks, that current page response status is equal to specified.
-     *
      * @Then /^the response status code should be (?P<code>\d+)$/
-     *
      * Example: And the url should match "/heroes/\w+"
      * Example: Then the url should match "/heroes/\w+"
-     *
      */
     public function assertResponseStatus($code)
     {
@@ -312,12 +261,9 @@ public function assertResponseStatus($code)
 
     /**
      * Checks, that current page response status is not equal to specified.
-     *
      * @Then /^the response status code should not be (?P<code>\d+)$/
-     *
      * Example: And the response status code should not be 404
      * Example: Then the response status code should not be 404
-     *
      */
     public function assertResponseStatusIsNot($code)
     {
@@ -326,12 +272,9 @@ public function assertResponseStatusIsNot($code)
 
     /**
      * Checks, that page contains specified text.
-     *
      * @Then /^(?:|I )should see "(?P<text>(?:[^"]|\\")*)"$/
-     *
      * Example: And I should see "This just in, Bruce Wayne is not Batman"
      * Example: Then I should see "This just in, Bruce Wayne is not Batman"
-     *
      */
     public function assertPageContainsText($text)
     {
@@ -340,12 +283,9 @@ public function assertPageContainsText($text)
 
     /**
      * Checks, that page doesn't contain specified text.
-     *
      * @Then /^(?:|I )should not see "(?P<text>(?:[^"]|\\")*)"$/
-     *
      * Example: And I should not see "This just in, Bruce Wayne is Batman"
      * Example: Then I should not see "This just in, Bruce Wayne is Batman"
-     *
      */
     public function assertPageNotContainsText($text)
     {
@@ -354,12 +294,9 @@ public function assertPageNotContainsText($text)
 
     /**
      * Checks, that page contains text matching specified pattern.
-     *
      * @Then /^(?:|I )should see text matching (?P<pattern>"(?:[^"]|\\")*")$/
-     *
      * Example: And I should not see "This just in, Bruce Wayne is Batman"
      * Example: Then I should not see "This just in, Bruce Wayne is Batman"
-     *
      */
     public function assertPageMatchesText($pattern)
     {
@@ -368,12 +305,9 @@ public function assertPageMatchesText($pattern)
 
     /**
      * Checks, that page doesn't contain text matching specified pattern.
-     *
      * @Then /^(?:|I )should not see text matching (?P<pattern>"(?:[^"]|\\")*")$/
-     *
      * Example: And I should not see text matching "Bruce Wayne is Batman"
      * Example: Then I should not see text matching "Bruce Wayne is Batman"
-     *
      */
     public function assertPageNotMatchesText($pattern)
     {
@@ -382,12 +316,9 @@ public function assertPageNotMatchesText($pattern)
 
     /**
      * Checks, that HTML response contains specified string.
-     *
      * @Then /^the response should contain "(?P<text>(?:[^"]|\\")*)"$/
-     *
      * Example: And the response should contain "<noscript>Sorry turn JavaScript on to view full experience</noscript>"
      * Example: Then the response should contain "<noscript>Sorry turn JavaScript on to view full experience</noscript>"
-     *
      */
     public function assertResponseContains($text)
     {
@@ -396,12 +327,9 @@ public function assertResponseContains($text)
 
     /**
      * Checks, that HTML response doesn't contain specified string.
-     *
      * @Then /^the response should not contain "(?P<text>(?:[^"]|\\")*)"$/
-     *
      * Example: And the response should not contain "v1.0.1"
      * Example: Then the response should not contain "v1.0.1"
-     *
      */
     public function assertResponseNotContains($text)
     {
@@ -410,12 +338,9 @@ public function assertResponseNotContains($text)
 
     /**
      * Checks, that element with specified CSS contains specified text.
-     *
      * @Then /^(?:|I )should see "(?P<text>(?:[^"]|\\")*)" in the "(?P<element>[^"]*)" element$/
-     *
      * Example: And I should see "Batman is dead?" in the "headline" element
      * Example: Then I should see "Batman is dead?" in the "headline" element
-     *
      */
     public function assertElementContainsText($element, $text)
     {
@@ -424,12 +349,9 @@ public function assertElementContainsText($element, $text)
 
     /**
      * Checks, that element with specified CSS doesn't contain specified text.
-     *
      * @Then /^(?:|I )should not see "(?P<text>(?:[^"]|\\")*)" in the "(?P<element>[^"]*)" element$/
-     *
      * Example: And I should not see "Batman is alive?" in the "headline" element
      * Example: Then I should not see "Batman is alive?" in the "headline" element
-     *
      */
     public function assertElementNotContainsText($element, $text)
     {
@@ -438,12 +360,9 @@ public function assertElementNotContainsText($element, $text)
 
     /**
      * Checks, that element with specified CSS contains specified HTML.
-     *
      * @Then /^the "(?P<element>[^"]*)" element should contain "(?P<value>(?:[^"]|\\")*)"$/
-     *
      * Example: And the "nav" element should contain "profile"
      * Example: Then the "nav" element should contain "profile"
-     *
      */
     public function assertElementContains($element, $value)
     {
@@ -452,12 +371,9 @@ public function assertElementContains($element, $value)
 
     /**
      * Checks, that element with specified CSS doesn't contain specified HTML.
-     *
      * @Then /^the "(?P<element>[^"]*)" element should not contain "(?P<value>(?:[^"]|\\")*)"$/
-     *
      * Example: And the "nav" element should not contain "logged-in"
      * Example: Then the "nav" element should not contain "logged-in"
-     *
      */
     public function assertElementNotContains($element, $value)
     {
@@ -466,12 +382,9 @@ public function assertElementNotContains($element, $value)
 
     /**
      * Checks, that element with specified CSS exists on page.
-     *
      * @Then /^(?:|I )should see an? "(?P<element>[^"]*)" element$/
-     *
      * Example: And I should see a "canvas" element
      * Example: Then I should see an "apples" element
-     *
      */
     public function assertElementOnPage($element)
     {
@@ -480,12 +393,9 @@ public function assertElementOnPage($element)
 
     /**
      * Checks, that element with specified CSS doesn't exist on page.
-     *
      * @Then /^(?:|I )should not see an? "(?P<element>[^"]*)" element$/
-     *
      * Example: And I should not see a "canvas" element
      * Example: Then I should not see an "apples" element
-     *
      */
     public function assertElementNotOnPage($element)
     {
@@ -494,12 +404,9 @@ public function assertElementNotOnPage($element)
 
     /**
      * Checks, that form field with specified id|name|label|value has specified value.
-     *
      * @Then /^the "(?P<field>(?:[^"]|\\")*)" field should contain "(?P<value>(?:[^"]|\\")*)"$/
-     *
      * Example: And the "name" field should contain "Bruce Wayne"
      * Example: Then the "name" field should contain "Bruce Wayne"
-     *
      */
     public function assertFieldContains($field, $value)
     {
@@ -510,12 +417,9 @@ public function assertFieldContains($field, $value)
 
     /**
      * Checks, that form field with specified id|name|label|value doesn't have specified value.
-     *
      * @Then /^the "(?P<field>(?:[^"]|\\")*)" field should not contain "(?P<value>(?:[^"]|\\")*)"$/
-     *
      * Example: And the "name" field should not contain "Bruce Wayne"
      * Example: Then the "name" field should not contain "Bruce Wayne"
-     *
      */
     public function assertFieldNotContains($field, $value)
     {
@@ -526,13 +430,10 @@ public function assertFieldNotContains($field, $value)
 
     /**
      * Checks, that checkbox with specified in|name|label|value is checked.
-     *
      * @Then /^the "(?P<checkbox>(?:[^"]|\\")*)" checkbox should be checked$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" (?:is|should be) checked$/
-     *
      * Example: And the "heroes" checkbox should be checked
      * Example: Then the "heroes" checkbox is checked
-     *
      */
     public function assertCheckboxChecked($checkbox)
     {
@@ -541,14 +442,11 @@ public function assertCheckboxChecked($checkbox)
 
     /**
      * Checks, that checkbox with specified in|name|label|value is unchecked.
-     *
      * @Then /^the "(?P<checkbox>(?:[^"]|\\")*)" checkbox should not be checked$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" should (?:be unchecked|not be checked)$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" is (?:unchecked|not checked)$/
-     *
      * Example: And the "villains" checkbox should be unchecked
      * Example: Then the "villains" checkbox is not checked
-     *
      */
     public function assertCheckboxNotChecked($checkbox)
     {
@@ -557,12 +455,9 @@ public function assertCheckboxNotChecked($checkbox)
 
     /**
      * Checks, that (?P<num>\d+) CSS elements exist on the page
-     *
      * @Then /^(?:|I )should see (?P<num>\d+) "(?P<element>[^"]*)" elements?$/
-     *
      * Example: And I should see 5 "div" elements
      * Example: Then I should see 5 "div" elements
-     *
      */
     public function assertNumElements($num, $element)
     {
@@ -571,11 +466,8 @@ public function assertNumElements($num, $element)
 
     /**
      * Prints current URL to console.
-     *
      * @Then /^print current URL$/
-     *
      * Example: Then print current URL
-     *
      */
     public function printCurrentUrl()
     {
@@ -584,11 +476,8 @@ public function printCurrentUrl()
 
     /**
      * Prints last response to console.
-     *
      * @Then /^print last response$/
-     *
      * Example: Then print last response
-     *
      */
     public function printLastResponse()
     {
@@ -600,11 +489,8 @@ public function printLastResponse()
 
     /**
      * Opens last response content in browser.
-     *
      * @Then /^show last response$/
-     *
-     * Example: Then show last responsecd
-     *
+     * Example: Then show last response
      */
     public function showLastResponse()
     {

From 1d12b01eeb49180fdb0ffb84e7fe1d1c9d2cc10a Mon Sep 17 00:00:00 2001
From: Sajjad Hossain <sajjad@adcade.com>
Date: Mon, 1 Jun 2015 12:39:30 -0400
Subject: [PATCH 3/4] added addtional documents, added examples to all step
 definitions for additional clarity when running 'behat -di' or 'behat -dl'

---
 .../MinkExtension/Context/MinkContext.php     | 179 ++++++++++++++----
 1 file changed, 140 insertions(+), 39 deletions(-)

diff --git a/src/Behat/MinkExtension/Context/MinkContext.php b/src/Behat/MinkExtension/Context/MinkContext.php
index 90ea0380..95ae8b87 100644
--- a/src/Behat/MinkExtension/Context/MinkContext.php
+++ b/src/Behat/MinkExtension/Context/MinkContext.php
@@ -22,7 +22,10 @@
 class MinkContext extends RawMinkContext implements TranslatableContext
 {
     /**
-     * Opens homepage.
+     * Opens homepage
+     * Example: Given I am on "/"
+     * Example: When I go to "/"
+     * Example: And I go to "/"
      *
      * @Given /^(?:|I )am on (?:|the )homepage$/
      * @When /^(?:|I )go to (?:|the )homepage$/
@@ -33,7 +36,10 @@ public function iAmOnHomepage()
     }
 
     /**
-     * Opens specified page.
+     * Opens specified page
+     * Example: Given I am on "http://batman.com"
+     * Example: When I am on "http://batman.com"
+     * Example: And I go to "http://batman.com"
      *
      * @Given /^(?:|I )am on "(?P<page>[^"]+)"$/
      * @When /^(?:|I )go to "(?P<page>[^"]+)"$/
@@ -44,7 +50,10 @@ public function visit($page)
     }
 
     /**
-     * Reloads current page.
+     * Reloads current page
+     * Example: Given I reload the page
+     * Example: When I reload the page
+     * Example: And I reload the page
      *
      * @When /^(?:|I )reload the page$/
      */
@@ -54,7 +63,10 @@ public function reload()
     }
 
     /**
-     * Moves backward one page in history.
+     * Moves backward one page in history
+     * Example: Given I move backward one page
+     * Example: When I move backward one page
+     * Example: And I move backward one page
      *
      * @When /^(?:|I )move backward one page$/
      */
@@ -65,6 +77,9 @@ public function back()
 
     /**
      * Moves forward one page in history
+     * Example: Given I move forward one page
+     * Example: When I move forward one page
+     * Example: And I move forward one page
      *
      * @When /^(?:|I )move forward one page$/
      */
@@ -74,7 +89,10 @@ public function forward()
     }
 
     /**
-     * Presses button with specified id|name|title|alt|value.
+     * Presses button with specified id|name|title|alt|value
+     * Example: Given I press "Log In"
+     * Example: When I press "Log In"
+     * Example: And I press "Log In"
      *
      * @When /^(?:|I )press "(?P<button>(?:[^"]|\\")*)"$/
      */
@@ -85,7 +103,10 @@ public function pressButton($button)
     }
 
     /**
-     * Clicks link with specified id|title|alt|text.
+     * Clicks link with specified id|title|alt|text
+     * Example: Given I follow "Log In"
+     * Example: When I follow "Log In"
+     * Example: And I follow "Log In"
      *
      * @When /^(?:|I )follow "(?P<link>(?:[^"]|\\")*)"$/
      */
@@ -96,7 +117,10 @@ public function clickLink($link)
     }
 
     /**
-     * Fills in form field with specified id|name|label|value.
+     * Fills in form field with specified id|name|label|value
+     * Example: Given I fill in "username" with: "bwayne"
+     * Example: When I fill in "username" with: "bwayne"
+     * Example: And I fill in "bwayne" for "username"
      *
      * @When /^(?:|I )fill in "(?P<field>(?:[^"]|\\")*)" with "(?P<value>(?:[^"]|\\")*)"$/
      * @When /^(?:|I )fill in "(?P<field>(?:[^"]|\\")*)" with:$/
@@ -110,7 +134,16 @@ public function fillField($field, $value)
     }
 
     /**
-     * Fills in form fields with provided table.
+     * Fills in form fields with provided table
+     * Example: Given I fill in the following"
+     *              | username | bruceWayne |
+     *              | password | iLoveBats123 |
+     * Example: When I fill in the following"
+     *              | username | bruceWayne |
+     *              | password | iLoveBats123 |
+     * Example: And I fill in the following"
+     *              | username | bruceWayne |
+     *              | password | iLoveBats123 |
      *
      * @When /^(?:|I )fill in the following:$/
      */
@@ -122,7 +155,10 @@ public function fillFields(TableNode $fields)
     }
 
     /**
-     * Selects option in select field with specified id|name|label|value.
+     * Selects option in select field with specified id|name|label|value
+     * Example: Given I select "Bats" from "user_fears"
+     * Example: When I select "Bats" from "user_fears"
+     * Example: And I select "Bats" from "user_fears"
      *
      * @When /^(?:|I )select "(?P<option>(?:[^"]|\\")*)" from "(?P<select>(?:[^"]|\\")*)"$/
      */
@@ -134,7 +170,10 @@ public function selectOption($select, $option)
     }
 
     /**
-     * Selects additional option in select field with specified id|name|label|value.
+     * Selects additional option in select field with specified id|name|label|value
+     * Example: Given I additionally select "Deceased" from "parents_alive_status"
+     * Example: When I additionally select "Deceased" from "parents_alive_status"
+     * Example: And I additionally select "Deceased" from "parents_alive_status"
      *
      * @When /^(?:|I )additionally select "(?P<option>(?:[^"]|\\")*)" from "(?P<select>(?:[^"]|\\")*)"$/
      */
@@ -146,7 +185,10 @@ public function additionallySelectOption($select, $option)
     }
 
     /**
-     * Checks checkbox with specified id|name|label|value.
+     * Checks checkbox with specified id|name|label|value
+     * Example: Given I check "Pearl Necklace" from "itemsClaimed"
+     * Example: When I check "Pearl Necklace" from "itemsClaimed"
+     * Example: And I check "Pearl Necklace" from "itemsClaimed"
      *
      * @When /^(?:|I )check "(?P<option>(?:[^"]|\\")*)"$/
      */
@@ -157,7 +199,10 @@ public function checkOption($option)
     }
 
     /**
-     * Unchecks checkbox with specified id|name|label|value.
+     * Unchecks checkbox with specified id|name|label|value
+     * Example: Given I uncheck "Broadway Plays" from "hobbies"
+     * Example: When I uncheck "Broadway Plays" from "hobbies"
+     * Example: And I uncheck "Broadway Plays" from "hobbies"
      *
      * @When /^(?:|I )uncheck "(?P<option>(?:[^"]|\\")*)"$/
      */
@@ -168,7 +213,10 @@ public function uncheckOption($option)
     }
 
     /**
-     * Attaches file to field with specified id|name|label|value.
+     * Attaches file to field with specified id|name|label|value
+     * Example: Given I attach "bwayne_profile.png" to "profileImageUpload"
+     * Example: When I attach "bwayne_profile.png" to "profileImageUpload"
+     * Example: And I attach "bwayne_profile.png" to "profileImageUpload"
      *
      * @When /^(?:|I )attach the file "(?P<path>[^"]*)" to "(?P<field>(?:[^"]|\\")*)"$/
      */
@@ -187,7 +235,10 @@ public function attachFileToField($field, $path)
     }
 
     /**
-     * Checks, that current page PATH is equal to specified.
+     * Checks, that current page PATH is equal to specified
+     * Example: Then I should be on "/"
+     * Example: And I should be on "/bats"
+     * Example: And I should be on "http://google.com"
      *
      * @Then /^(?:|I )should be on "(?P<page>[^"]+)"$/
      */
@@ -197,7 +248,9 @@ public function assertPageAddress($page)
     }
 
     /**
-     * Checks, that current page is the homepage.
+     * Checks, that current page is the homepage
+     * Example: Then I should be on the homepage
+     * Example: And I should be on the homepage
      *
      * @Then /^(?:|I )should be on (?:|the )homepage$/
      */
@@ -207,7 +260,10 @@ public function assertHomepage()
     }
 
     /**
-     * Checks, that current page PATH matches regular expression.
+     * Checks, that current page PATH matches regular expression
+     * Example: Then the url should match "superman is dead"
+     * Example: Then the uri should match "log in"
+     * Example: And the url should match "log in"
      *
      * @Then /^the (?i)url(?-i) should match (?P<pattern>"(?:[^"]|\\")*")$/
      */
@@ -217,7 +273,9 @@ public function assertUrlRegExp($pattern)
     }
 
     /**
-     * Checks, that current page response status is equal to specified.
+     * Checks, that current page response status is equal to specified
+     * Example: Then the response status code should be 200
+     * Example: And the response status code should be 400
      *
      * @Then /^the response status code should be (?P<code>\d+)$/
      */
@@ -227,7 +285,9 @@ public function assertResponseStatus($code)
     }
 
     /**
-     * Checks, that current page response status is not equal to specified.
+     * Checks, that current page response status is not equal to specified
+     * Example: Then the response status code should not be 501
+     * Example: And the response status code should not be 404
      *
      * @Then /^the response status code should not be (?P<code>\d+)$/
      */
@@ -237,7 +297,9 @@ public function assertResponseStatusIsNot($code)
     }
 
     /**
-     * Checks, that page contains specified text.
+     * Checks, that page contains specified text
+     * Example: Then I should see "Who is the Batman?"
+     * Example: And I should see "Who is the Batman?"
      *
      * @Then /^(?:|I )should see "(?P<text>(?:[^"]|\\")*)"$/
      */
@@ -247,7 +309,9 @@ public function assertPageContainsText($text)
     }
 
     /**
-     * Checks, that page doesn't contain specified text.
+     * Checks, that page doesn't contain specified text
+     * Example: Then I should not see "Batman is Bruce Wayne"
+     * Example: And I should not see "Batman is Bruce Wayne"
      *
      * @Then /^(?:|I )should not see "(?P<text>(?:[^"]|\\")*)"$/
      */
@@ -257,7 +321,9 @@ public function assertPageNotContainsText($text)
     }
 
     /**
-     * Checks, that page contains text matching specified pattern.
+     * Checks, that page contains text matching specified pattern
+     * Example: Then I should see text matching "Batman, the vigilante"
+     * Example: And I should not see "Batman, the vigilante"
      *
      * @Then /^(?:|I )should see text matching (?P<pattern>"(?:[^"]|\\")*")$/
      */
@@ -267,7 +333,9 @@ public function assertPageMatchesText($pattern)
     }
 
     /**
-     * Checks, that page doesn't contain text matching specified pattern.
+     * Checks, that page doesn't contain text matching specified pattern
+     * Example: Then I should see text matching "Bruce Wayne, the vigilante"
+     * Example: And I should not see "Bruce Wayne, the vigilante"
      *
      * @Then /^(?:|I )should not see text matching (?P<pattern>"(?:[^"]|\\")*")$/
      */
@@ -277,7 +345,9 @@ public function assertPageNotMatchesText($pattern)
     }
 
     /**
-     * Checks, that HTML response contains specified string.
+     * Checks, that HTML response contains specified string
+     * Example: Then the response should contain "Batman is the hero Gotham deserves."
+     * Example: And the response should contain "Batman is the hero Gotham deserves."
      *
      * @Then /^the response should contain "(?P<text>(?:[^"]|\\")*)"$/
      */
@@ -287,7 +357,9 @@ public function assertResponseContains($text)
     }
 
     /**
-     * Checks, that HTML response doesn't contain specified string.
+     * Checks, that HTML response doesn't contain specified string
+     * Example: Then the response should not contain "Bruce Wayne is a billionaire, play-boy, vigilante."
+     * Example: And the response should not contain "Bruce Wayne is a billionaire, play-boy, vigilante."
      *
      * @Then /^the response should not contain "(?P<text>(?:[^"]|\\")*)"$/
      */
@@ -297,7 +369,9 @@ public function assertResponseNotContains($text)
     }
 
     /**
-     * Checks, that element with specified CSS contains specified text.
+     * Checks, that element with specified CSS contains specified text
+     * Example: Then I should see "Batman" in the "heroes_list" element
+     * Example: And I should see "Batman" in the "heroes_list" element
      *
      * @Then /^(?:|I )should see "(?P<text>(?:[^"]|\\")*)" in the "(?P<element>[^"]*)" element$/
      */
@@ -307,7 +381,9 @@ public function assertElementContainsText($element, $text)
     }
 
     /**
-     * Checks, that element with specified CSS doesn't contain specified text.
+     * Checks, that element with specified CSS doesn't contain specified text
+     * Example: Then I should not see "Bruce Wayne" in the "heroes_alter_egos" element
+     * Example: And I should not see "Bruce Wayne" in the "heroes_alter_egos" element
      *
      * @Then /^(?:|I )should not see "(?P<text>(?:[^"]|\\")*)" in the "(?P<element>[^"]*)" element$/
      */
@@ -317,7 +393,9 @@ public function assertElementNotContainsText($element, $text)
     }
 
     /**
-     * Checks, that element with specified CSS contains specified HTML.
+     * Checks, that element with specified CSS contains specified HTML
+     * Example: Then the "body" element should contain "style=\"color:black;\""
+     * Example: And the "body" element should contain "style=\"color:black;\""
      *
      * @Then /^the "(?P<element>[^"]*)" element should contain "(?P<value>(?:[^"]|\\")*)"$/
      */
@@ -327,7 +405,9 @@ public function assertElementContains($element, $value)
     }
 
     /**
-     * Checks, that element with specified CSS doesn't contain specified HTML.
+     * Checks, that element with specified CSS doesn't contain specified HTML
+     * Example: Then the "body" element should not contain "style=\"color:black;\""
+     * Example: And the "body" element should not contain "style=\"color:black;\""
      *
      * @Then /^the "(?P<element>[^"]*)" element should not contain "(?P<value>(?:[^"]|\\")*)"$/
      */
@@ -337,7 +417,9 @@ public function assertElementNotContains($element, $value)
     }
 
     /**
-     * Checks, that element with specified CSS exists on page.
+     * Checks, that element with specified CSS exists on page
+     * Example: Then I should see a "body" element
+     * Example: And I should see a "body" element
      *
      * @Then /^(?:|I )should see an? "(?P<element>[^"]*)" element$/
      */
@@ -347,7 +429,9 @@ public function assertElementOnPage($element)
     }
 
     /**
-     * Checks, that element with specified CSS doesn't exist on page.
+     * Checks, that element with specified CSS doesn't exist on page
+     * Example: Then I should not see a "canvas" element
+     * Example: And I should not see a "canvas" element
      *
      * @Then /^(?:|I )should not see an? "(?P<element>[^"]*)" element$/
      */
@@ -357,7 +441,9 @@ public function assertElementNotOnPage($element)
     }
 
     /**
-     * Checks, that form field with specified id|name|label|value has specified value.
+     * Checks, that form field with specified id|name|label|value has specified value
+     * Example: Then the "username" field should contain "bwayne"
+     * Example: And the "username" field should contain "bwayne"
      *
      * @Then /^the "(?P<field>(?:[^"]|\\")*)" field should contain "(?P<value>(?:[^"]|\\")*)"$/
      */
@@ -369,7 +455,9 @@ public function assertFieldContains($field, $value)
     }
 
     /**
-     * Checks, that form field with specified id|name|label|value doesn't have specified value.
+     * Checks, that form field with specified id|name|label|value doesn't have specified value
+     * Example: Then the "username" field should not contain "batman"
+     * Example: And the "username" field should not contain "batman"
      *
      * @Then /^the "(?P<field>(?:[^"]|\\")*)" field should not contain "(?P<value>(?:[^"]|\\")*)"$/
      */
@@ -381,7 +469,9 @@ public function assertFieldNotContains($field, $value)
     }
 
     /**
-     * Checks, that checkbox with specified in|name|label|value is checked.
+     * Checks, that checkbox with specified in|name|label|value is checked
+     * Example: Then the "remember_me" checkbox should be checked
+     * Example: And the "remember_me" checkbox is checked
      *
      * @Then /^the "(?P<checkbox>(?:[^"]|\\")*)" checkbox should be checked$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" (?:is|should be) checked$/
@@ -392,7 +482,10 @@ public function assertCheckboxChecked($checkbox)
     }
 
     /**
-     * Checks, that checkbox with specified in|name|label|value is unchecked.
+     * Checks, that checkbox with specified in|name|label|value is unchecked
+     * Example: Then the "newsletter" checkbox should be unchecked
+     * Example: Then the "newsletter" checkbox should not be checked
+     * Example: And the "newsletter" checkbox is unchecked
      *
      * @Then /^the "(?P<checkbox>(?:[^"]|\\")*)" checkbox should not be checked$/
      * @Then /^the checkbox "(?P<checkbox>(?:[^"]|\\")*)" should (?:be unchecked|not be checked)$/
@@ -405,6 +498,8 @@ public function assertCheckboxNotChecked($checkbox)
 
     /**
      * Checks, that (?P<num>\d+) CSS elements exist on the page
+     * Example: Then I should see 5 "div" elements
+     * Example: And I should see 5 "div" elements
      *
      * @Then /^(?:|I )should see (?P<num>\d+) "(?P<element>[^"]*)" elements?$/
      */
@@ -415,6 +510,8 @@ public function assertNumElements($num, $element)
 
     /**
      * Prints current URL to console.
+     * Example: Then print current URL
+     * Example: And print current URL
      *
      * @Then /^print current URL$/
      */
@@ -424,7 +521,9 @@ public function printCurrentUrl()
     }
 
     /**
-     * Prints last response to console.
+     * Prints last response to console
+     * Example: Then print current response
+     * Example: And print current response
      *
      * @Then /^print last response$/
      */
@@ -437,7 +536,9 @@ public function printLastResponse()
     }
 
     /**
-     * Opens last response content in browser.
+     * Opens last response content in browser
+     * Example: Then show last response
+     * Example: And show last response
      *
      * @Then /^show last response$/
      */
@@ -453,7 +554,7 @@ public function showLastResponse()
     }
 
     /**
-     * Returns list of definition translation resources paths.
+     * Returns list of definition translation resources paths
      *
      * @return array
      */
@@ -463,7 +564,7 @@ public static function getTranslationResources()
     }
 
     /**
-     * Returns list of definition translation resources paths for this dictionary.
+     * Returns list of definition translation resources paths for this dictionary
      *
      * @return array
      */
@@ -473,7 +574,7 @@ public static function getMinkTranslationResources()
     }
 
     /**
-     * Returns fixed step argument (with \\" replaced back to ").
+     * Returns fixed step argument (with \\" replaced back to ")
      *
      * @param string $argument
      *

From 2b0bdece038cd1c2b41a056e36588c88c62af072 Mon Sep 17 00:00:00 2001
From: Sajjad Hossain <sajjad@adcade.com>
Date: Tue, 9 Jun 2015 13:14:48 -0400
Subject: [PATCH 4/4] removed incorrect usage of Given, removed excess comment
 breaks, fixed order of methods (done in error), removed some instances of AND

---
 .../MinkExtension/Context/MinkContext.php     | 41 ++++++-------------
 1 file changed, 12 insertions(+), 29 deletions(-)

diff --git a/src/Behat/MinkExtension/Context/MinkContext.php b/src/Behat/MinkExtension/Context/MinkContext.php
index db091518..a5bfa30f 100644
--- a/src/Behat/MinkExtension/Context/MinkContext.php
+++ b/src/Behat/MinkExtension/Context/MinkContext.php
@@ -51,12 +51,10 @@ public function visit($page)
 
     /**
      * Reloads current page
-     * Example: Given I reload the page
      * Example: When I reload the page
      * Example: And I reload the page
      *
      * @When /^(?:|I )reload the page$/
-     *
      */
     public function reload()
     {
@@ -65,9 +63,7 @@ public function reload()
 
     /**
      * Moves backward one page in history
-     * Example: Given I move backward one page
      * Example: When I move backward one page
-     * Example: And I move backward one page
      *
      * @When /^(?:|I )move backward one page$/
      */
@@ -78,8 +74,6 @@ public function back()
 
     /**
      * Moves forward one page in history
-     * Example: Given I move forward one page
-     * Example: When I move forward one page
      * Example: And I move forward one page
      *
      * @When /^(?:|I )move forward one page$/
@@ -91,7 +85,6 @@ public function forward()
 
     /**
      * Presses button with specified id|name|title|alt|value
-     * Example: Given I press "Log In"
      * Example: When I press "Log In"
      * Example: And I press "Log In"
      *
@@ -105,7 +98,6 @@ public function pressButton($button)
 
     /**
      * Clicks link with specified id|title|alt|text
-     * Example: Given I follow "Log In"
      * Example: When I follow "Log In"
      * Example: And I follow "Log In"
      *
@@ -119,7 +111,6 @@ public function clickLink($link)
 
     /**
      * Fills in form field with specified id|name|label|value
-     * Example: Given I fill in "username" with "bwayne"
      * Example: When I fill in "username" with: "bwayne"
      * Example: And I fill in "bwayne" for "username"
      *
@@ -136,9 +127,6 @@ public function fillField($field, $value)
 
     /**
      * Fills in form fields with provided table
-     * Example: Given I fill in the following"
-     *              | username | bruceWayne |
-     *              | password | iLoveBats123 |
      * Example: When I fill in the following"
      *              | username | bruceWayne |
      *              | password | iLoveBats123 |
@@ -157,7 +145,6 @@ public function fillFields(TableNode $fields)
 
     /**
      * Selects option in select field with specified id|name|label|value
-     * Example: Given I select "Bats" from "user_fears"
      * Example: When I select "Bats" from "user_fears"
      * Example: And I select "Bats" from "user_fears"
      *
@@ -172,7 +159,6 @@ public function selectOption($select, $option)
 
     /**
      * Selects additional option in select field with specified id|name|label|value
-     * Example: Given I additionally select "Deceased" from "parents_alive_status"
      * Example: When I additionally select "Deceased" from "parents_alive_status"
      * Example: And I additionally select "Deceased" from "parents_alive_status"
      *
@@ -187,7 +173,6 @@ public function additionallySelectOption($select, $option)
 
     /**
      * Checks checkbox with specified id|name|label|value
-     * Example: Given I check "Pearl Necklace" from "itemsClaimed"
      * Example: When I check "Pearl Necklace" from "itemsClaimed"
      * Example: And I check "Pearl Necklace" from "itemsClaimed"
      *
@@ -201,7 +186,6 @@ public function checkOption($option)
 
     /**
      * Unchecks checkbox with specified id|name|label|value
-     * Example: Given I uncheck "Broadway Plays" from "hobbies"
      * Example: When I uncheck "Broadway Plays" from "hobbies"
      * Example: And I uncheck "Broadway Plays" from "hobbies"
      *
@@ -215,7 +199,6 @@ public function uncheckOption($option)
 
     /**
      * Attaches file to field with specified id|name|label|value
-     * Example: Given I attach "bwayne_profile.png" to "profileImageUpload"
      * Example: When I attach "bwayne_profile.png" to "profileImageUpload"
      * Example: And I attach "bwayne_profile.png" to "profileImageUpload"
      *
@@ -469,6 +452,18 @@ public function assertFieldNotContains($field, $value)
         $this->assertSession()->fieldValueNotEquals($field, $value);
     }
 
+    /**
+     * Checks, that (?P<num>\d+) CSS elements exist on the page
+     * Example: Then I should see 5 "div" elements
+     * Example: And I should see 5 "div" elements
+     *
+     * @Then /^(?:|I )should see (?P<num>\d+) "(?P<element>[^"]*)" elements?$/
+     */
+    public function assertNumElements($num, $element)
+    {
+        $this->assertSession()->elementsCount('css', $element, intval($num));
+    }
+
     /**
      * Checks, that checkbox with specified in|name|label|value is checked
      * Example: Then the "remember_me" checkbox should be checked
@@ -482,18 +477,6 @@ public function assertCheckboxChecked($checkbox)
         $this->assertSession()->checkboxChecked($this->fixStepArgument($checkbox));
     }
 
-    /**
-     * Checks, that (?P<num>\d+) CSS elements exist on the page
-     * Example: Then I should see 5 "div" elements
-     * Example: And I should see 5 "div" elements
-     *
-     * @Then /^(?:|I )should see (?P<num>\d+) "(?P<element>[^"]*)" elements?$/
-     */
-    public function assertNumElements($num, $element)
-    {
-        $this->assertSession()->elementsCount('css', $element, intval($num));
-    }
-
     /**
      * Checks, that checkbox with specified in|name|label|value is unchecked
      * Example: Then the "newsletter" checkbox should be unchecked