Clarified README (#557)

* Clarified README

- simplified some word choice for those new to the project and non-primary English speakers
- corrected grammar
- removed unnecessary words (clutter)
- corrected sentence fragments
- corrected improper verb choices
- added extra headers to clarify purpose of each set of steps
- rearranged some sentences so the focus of the sentence came earlier and/or became the subject

Author: agentFinland

README.md

@@ -16,12 +16,12 @@ by the Selenium server and will also implement the [W3C WebDriver](https://w3c.g
 The concepts of this library are very similar to the "official" Java, .NET, Python and Ruby bindings from the
 [Selenium project](https://github.com/SeleniumHQ/selenium/).
 
-**This is new version of PHP client, rewritten from scratch starting 2013.**
+**As of 2013, this PHP client has been rewritten from scratch.**
 Using the old version? Check out [Adam Goucher's fork](https://github.com/Element-34/php-webdriver) of it.
 
 Looking for API documentation of php-webdriver? See [https://facebook.github.io/php-webdriver/](https://facebook.github.io/php-webdriver/latest/)
 
-Any complaint, question, idea? You can post it on the user group https://www.facebook.com/groups/phpwebdriver/.
+Any complaints, questions, or ideas? Post them in the user group https://www.facebook.com/groups/phpwebdriver/.
 
 ## Installation
 
@@ -37,15 +37,19 @@ Then install the library:
 
 ## Getting started
 
-All you need as the server for this client is the `selenium-server-standalone-#.jar` file provided here: http://selenium-release.storage.googleapis.com/index.html
+### Start Server
 
-Download and run that file, replacing # with the current server version. Keep in mind you must have Java 8+ installed to start this command.
+The required server is the `selenium-server-standalone-#.jar` file provided here: http://selenium-release.storage.googleapis.com/index.html
+
+Download and run the server by replacing # with the current server version. Keep in mind **you must have Java 8+ installed to run this command**.
 
     java -jar selenium-server-standalone-#.jar
 
-(Please see note below when using Firefox.)
+**NOTE:** If using Firefox, see alternate command below.
+
+### Create a Browser Session
 
-Then when you create a session, be sure to pass the url to where your server is running.
+When creating a browser session, be sure to pass the url of your running server.
 
 ```php
 // This would be the url of the host running the server-standalone.jar
@@ -54,7 +58,7 @@ $host = 'http://localhost:4444/wd/hub'; // this is the default
 
 ##### Launch Chrome
 
-Make sure to have latest Chrome and [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/downloads) installed.
+Make sure to have latest Chrome and [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/downloads) versions installed.
 
 ```php
 $driver = RemoteWebDriver::create($host, DesiredCapabilities::chrome());
@@ -64,8 +68,8 @@ $driver = RemoteWebDriver::create($host, DesiredCapabilities::chrome());
 
 Make sure to have latest Firefox and [Geckodriver](https://github.com/mozilla/geckodriver/releases) installed.
 
-Because Firefox (and Geckodriver) only supports new W3C WebDriver protocol (which is yet to be implemented by php-wedbriver - see [issue #469](https://github.com/facebook/php-webdriver/issues/469)),
-the protocols must be translated by Selenium server - this feature is *partially* available in Selenium server version 3.5.0-3.8.1 and you can enable it like this:
+Because Firefox (and Geckodriver) only support the new W3C WebDriver protocol (which is yet to be implemented by php-webdriver - see [issue #469](https://github.com/facebook/php-webdriver/issues/469)),
+the protocols must be translated by Selenium Server - this feature is *partially* available in Selenium Server versions 3.5.0-3.8.1 and you can enable it like this:
 
     java -jar selenium-server-standalone-3.8.1.jar -enablePassThrough false
 
@@ -75,7 +79,7 @@ Now you can start Firefox from your code:
 $driver = RemoteWebDriver::create($host, DesiredCapabilities::firefox());
 ```
 
-##### You can also customize the desired capabilities
+### Customize Desired Capabilities
 
 ```php
 $desired_capabilities = DesiredCapabilities::firefox();
@@ -85,7 +89,7 @@ $driver = RemoteWebDriver::create($host, $desired_capabilities);
 
 * See https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities for more details.
 
-* Above snippets are not intended to be a working example by simply copy pasting. See [example.php](example.php) for working example.
+**NOTE:** Above snippets are not intended to be a working example by simply copy-pasting. See [example.php](example.php) for working example.
 
 ## Changelog
 For latest changes see [CHANGELOG.md](CHANGELOG.md) file.
@@ -98,22 +102,21 @@ You may also want to check out the Selenium [docs](http://docs.seleniumhq.org/do
 
 ## Testing framework integration
 
-To take advantage of automatized testing you will most probably want to integrate php-webdriver to your testing framework.
-There are some project already providing this:
+To take advantage of automatized testing you may want to integrate php-webdriver to your testing framework.
+There are some projects already providing this:
 
-- [Steward](https://github.com/lmc-eu/steward) integrates php-webdriver directly to [PHPUnit](https://phpunit.de/), also providers parallelization.
-- [Codeception](http://codeception.com) testing framework provides BDD-layer on top of php-webdriver in its [WebDriver module](http://codeception.com/docs/modules/WebDriver).
-- You can also check out this [blogpost](http://codeception.com/11-12-2013/working-with-phpunit-and-selenium-webdriver.html) + [demo project](https://github.com/DavertMik/php-webdriver-demo), describing simple [PHPUnit](https://phpunit.de/) integration.
+- [Steward](https://github.com/lmc-eu/steward) integrates php-webdriver directly to [PHPUnit](https://phpunit.de/), and provides parallelization
+- [Codeception](http://codeception.com) testing framework provides BDD-layer on top of php-webdriver in its [WebDriver module](http://codeception.com/docs/modules/WebDriver)
+- You can also check out this [blogpost](http://codeception.com/11-12-2013/working-with-phpunit-and-selenium-webdriver.html) + [demo project](https://github.com/DavertMik/php-webdriver-demo), describing simple [PHPUnit](https://phpunit.de/) integration
 
 ## Support
 
-We have a great community willing to try and help you!
+We have a great community willing to help you!
 
-- **Via our Facebook Group** - If you have questions or are an active contributor consider joining our [facebook group](https://www.facebook.com/groups/phpwebdriver/) and contributing to the communal discussion and support.
-- **Via StackOverflow** - You can also [ask a question](https://stackoverflow.com/questions/ask?tags=php+selenium-webdriver) or find many already answered question on StackOverflow.
-- **Via GitHub** - Another option if you have a question (or bug report) is to [submit it here](https://github.com/facebook/php-webdriver/issues/new) as an new issue.
+- **Via our Facebook Group** - If you have questions or are an active contributor consider joining our [facebook group](https://www.facebook.com/groups/phpwebdriver/) and contribute to communal discussion and support
+- **Via StackOverflow** - You can also [ask a question](https://stackoverflow.com/questions/ask?tags=php+selenium-webdriver) or find many already answered question on StackOverflow
+- **Via GitHub** - Another option if you have a question (or bug report) is to [submit it here](https://github.com/facebook/php-webdriver/issues/new) as an new issue
 
 ## Contributing
 
-We love to have your help to make php-webdriver better. See [CONTRIBUTING.md](CONTRIBUTING.md) for more information
-about contributing and developing php-webdriver.
+We love to have your help to make php-webdriver better. See [CONTRIBUTING.md](CONTRIBUTING.md) for more information about contributing and developing php-webdriver.