Small README improvements before next tag

README.md

@@ -4,6 +4,25 @@
 [![Latest Stable Version](https://poser.pugx.org/addwiki/mediawiki-api-base/version.png)](https://packagist.org/packages/addwiki/mediawiki-api-base)
 [![Download count](https://poser.pugx.org/addwiki/mediawiki-api-base/d/total.png)](https://packagist.org/packages/addwiki/mediawiki-api-base)
 
+This library provides basic access to the MediaWiki Action API.
+This library features simple methods allowing you to login, logout and do both GET and POST requests.
+This library should work with most if not all MediaWiki versions due to its simplicity.
+
+You can find the fill documentation at https://addwiki.github.io/mediawiki-api-base/
+
+## Example
+
+A quick example can be found below:
+
+```php
+use \Mediawiki\Api\MediawikiApi;
+
+$api = MediawikiApi::newFromPage( 'https://en.wikipedia.org/wiki/Berlin' );
+$api->login( new ApiUser( 'username', 'password' ) );
+$purgeRequest = FluentRequest::factory()->setAction( 'purge' )->setParam( 'titles', 'Berlin' );
+$api->postRequest( $purgeRequest );
+```
+
 ## Integration tests
 
 Run the MediaWiki test site: