Add more doc. Fix #242

Author: willdurand

CONTRIBUTING.md

@@ -0,0 +1,29 @@
+Contributing
+============
+
+First of all, thank you for contributing, you are awesome! Here are a few rules
+to follow in order to ease code reviews, and discussions before maintainers
+accept and merge your work.
+
+You MUST follow the [PSR-1](http://www.php-fig.org/psr/1/) and
+[PSR-2](http://www.php-fig.org/psr/2/). If you don't know about any of them, you
+should really read the recommendations. Can't wait? Use the [PHP-CS-Fixer
+tool](http://cs.sensiolabs.org/).
+
+You MUST run the test suite.
+
+You MUST write (or update) unit tests.
+
+You SHOULD write documentation.
+
+Please, write [commit messages that make
+sense](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html),
+and [rebase your branch](http://git-scm.com/book/en/Git-Branching-Rebasing)
+before submitting your Pull Request.
+
+One may ask you to [squash your
+commits](http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html)
+too. This is used to "clean" your Pull Request before merging it (we don't want
+commits such as `fix tests`, `fix 2`, `fix 3`, etc.).
+
+Thank you!

README.md

@@ -410,6 +410,7 @@ The Geocoder's API is fluent, you can write:
 $result = $geocoder
     ->registerProvider(new \My\Provider\Custom($adapter))
     ->using('custom')
+    ->limit(10)
     ->geocode('68.145.37.34')
     ;
 ```
@@ -418,6 +419,11 @@ The `using()` method allows you to choose the `provider` to use by its name.
 When you deal with multiple providers, you may want to choose one of them.
 The default behavior is to use the first one but it can be annoying.
 
+The `limit()` method allows you to configure the maximum number of results
+being returned. Depending on the provider you may not get as many results as
+expected, it is a maximum limit, not the expected number of results.
+
+
 Reverse Geocoding
 -----------------
 
@@ -555,6 +561,12 @@ You can provide your own `dumper` by implementing the `DumperInterface`.
 Write your own `formatter` by implementing the `FormatterInterface`.
 
 
+Contributing
+------------
+
+See CONTRIBUTING file.
+
+
 Unit Tests
 ----------
 

src/Geocoder/Geocoder.php

@@ -54,8 +54,7 @@ class Geocoder implements GeocoderInterface
      * @param ResultFactoryInterface $resultFactory
      * @param integer                $maxResults
      */
-    public function __construct(ProviderInterface $provider = null, ResultFactoryInterface $resultFactory = null,
-        $maxResults = self::MAX_RESULTS)
+    public function __construct(ProviderInterface $provider = null, ResultFactoryInterface $resultFactory = null, $maxResults = self::MAX_RESULTS)
     {
         $this->provider = $provider;