Improve readme

README.md

@@ -1,15 +1,48 @@
 # Mink WebDriver Classic Driver
 
+[![PHP Version](http://poser.pugx.org/mink/webdriver-classic-driver/require/php)](https://packagist.org/packages/mink/webdriver-classic-driver)
 [![Latest Stable Version](https://poser.pugx.org/mink/webdriver-classic-driver/v)](https://packagist.org/packages/mink/webdriver-classic-driver)
 [![Latest Unstable Version](https://poser.pugx.org/mink/webdriver-classic-driver/v/unstable)](https://packagist.org/packages/mink/webdriver-classic-driver)
 [![Total Downloads](https://poser.pugx.org/mink/webdriver-classic-driver/downloads)](https://packagist.org/packages/mink/webdriver-classic-driver)
 [![CI](https://github.com/minkphp/webdriver-classic-driver/actions/workflows/ci.yml/badge.svg)](https://github.com/minkphp/webdriver-classic-driver/actions/workflows/ci.yml)
 [![License](https://poser.pugx.org/mink/webdriver-classic-driver/license)](https://github.com/minkphp/webdriver-classic-driver/blob/main/LICENSE)
 [![codecov](https://codecov.io/gh/minkphp/webdriver-classic-driver/branch/main/graph/badge.svg?token=11hgqXqod9)](https://codecov.io/gh/minkphp/webdriver-classic-driver)
 
-## Usage Example
+A [php-webdriver](https://github.com/php-webdriver/php-webdriver)-based driver
+for [Mink](https://github.com/minkphp/Mink), supporting Selenium 2-4 and tested on Chrome, Firefox and Edge.
 
-``` php
+## Installation
+
+### For Mink/Standalone Usage
+
+Simply install the package with composer and check the [Standalone Usage Example](#standalone-usage-example) below.
+
+```shell
+composer require "behat/mink" "mink/webdriver-classic-driver"
+```
+
+### For Behat/BDD Usage
+
+1. Add all the relevant packages - typically this will be for testing your application, so you'd want to use `--dev`.
+    ```shell
+    composer require --dev "behat/behat" "behat/mink" "friends-of-behat/mink-extension" "mink/webdriver-classic-driver"
+    ```
+2. Configure Behat to enable the Mink Extension and set it to use this driver, for example:
+    ```yaml
+    # behat.yml
+    default:
+        extensions:
+            Behat\MinkExtension\Extension:
+                browser_name: chrome
+                base_url: https://example.com/
+                sessions:
+                    default:
+                        webdriver-classic: ~
+    ```
+
+## Standalone Usage Example
+
+```php
 <?php
 
 use Behat\Mink\Mink,
@@ -19,11 +52,11 @@ use Behat\Mink\Mink,
 require_once __DIR__ . '/vendor/autoload.php';
 
 $browserName = 'firefox';
-$url = 'http://example.com';
+$url = 'https://example.com';
 
-$mink = new Mink(array(
+$mink = new Mink([
     'webdriver-classic' => new Session(new WebdriverClassicDriver($browserName)),
-));
+]);
 
 $session = $mink->getSession('webdriver-classic');
 $session->visit($url);
@@ -33,29 +66,23 @@ $session->getPage()->findLink('Chat')->click();
 
 Please refer to [MinkExtension-example](https://github.com/Behat/MinkExtension-example) for an executable example.
 
-## Installation
-
-``` bash
-composer require behat/mink mink/webdriver-classic-driver
-```
-
 ## Testing
 
-1. Start WebDriver
-    1. If you have Docker installed, run
-    ```bash
-    docker run -p 4444:4444 selenium/standalone-firefox:4.18.1
-    ```
-    2. If you do not have Docker, but you have Java
-    ```bash
-    curl -L https://github.com/SeleniumHQ/selenium/releases/download/selenium-4.18.0/selenium-server-4.18.1.jar > selenium-server-4.18.1.jar
-    java -jar selenium-server-4.18.1.jar standalone
-    ```
+1. Start WebDriver:
+    1. If you have Docker installed, run:
+        ```shell
+        docker run -p 4444:4444 selenium/standalone-firefox:4.18.1
+        ```
+    2. If you do not have Docker, but you have Java, run:
+        ```shell
+        curl -L https://github.com/SeleniumHQ/selenium/releases/download/selenium-4.18.0/selenium-server-4.18.1.jar > selenium-server-4.18.1.jar
+        java -jar selenium-server-4.18.1.jar standalone
+        ```
 2. Start WebServer by running
-    ``` bash
+    ```shell
     ./vendor/bin/mink-test-server
     ```
 3. Start PhpUnit
-    ```bash
+    ```shell
     ./vendor/bin/phpunit -v --coverage-clover=coverage.clover
     ```