Merge pull request #375 from dunglas/docs/v0.8.0

docs: update CHANGELOG, add some docs and update geckodriver

Author: dunglas

CHANGELOG.md

@@ -1,6 +1,23 @@
 CHANGELOG
 =========
 
+0.8.0
+-----
+
+* Upgrade ChromeDriver to version 85.0.4183.87
+* Upgrade geckodriver to version 0.27.0
+* Add a `Client::waitForVisibility()` method to wait for an element to appear
+* Allow passing options to the browser manager from `PantherTestCase::createPantherClient()`
+* Add a `Client::ping()` method to check if the WebDriver connection is still active
+* Fix setting a new value to an input field when there is an existing value
+* Improve the error message when the web server crashes
+* Throw an explanative `LogicException` when driver is not started yet
+* Prevent timeouts caused by the integrated web server
+* Fix the value of cookie secure flags
+* Throw an exception when getting history (unsupported feature)
+* Add docs to use Panther with GitHub Actions
+* Various bug fixes and documentation improvements
+
 0.7.1
 -----
 

README.md

@@ -90,8 +90,10 @@ $client = \Symfony\Component\Panther\Client::createFirefoxClient();
 $client->request('GET', 'https://api-platform.com'); // Yes, this website is 100% written in JavaScript
 $client->clickLink('Get started');
 
-// Wait for an element to be rendered
+// Wait for an element to be present in the DOM (even if hidden)
 $crawler = $client->waitFor('#installing-the-framework');
+// Alternatively, wait for an element to be visible
+$crawler = $client->waitForVisibility('#installing-the-framework');
 
 echo $crawler->filter('#installing-the-framework')->text();
 $client->takeScreenshot('screen.png'); // Yeah, screenshot!
@@ -224,6 +226,10 @@ class ChatTest extends PantherTestCase
 }
 ```
 
+### Checking the State of the WebDriver Connection
+
+Use the `Client::ping()` method to check if the WebDriver connection is still active (useful for long running tasks).
+
 ## Additional Documentation
 
 Since Panther implements the API of popular libraries, it already has extensive documentation: