Merge pull request #62 from greg0ire/merge_1.x

Merge 1.x

Author: greg0ire

CHANGELOG.md

@@ -1,3 +1,20 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
+
+## [1.1.0](https://github.com/sonata-project/GoogleAuthenticator/compare/1.0.2...1.1.0) - 2017-04-19
+### Changed
+- Changed `getUrl` adding a new parameter : `$issuer`
+
+### Deprecated
+- Extending any class defined in the package is deprecated
+
+### Fixed
+- paths in sample code have been fixed
+
+### Removed
+- internal test classes are now excluded from the autoloader
+
+### Security
+- now generation of the secret is cryptographically strong.
+- Implemented constant time codes comparison

CONTRIBUTING.md

@@ -72,9 +72,29 @@ php-cs-fixer fix --verbose
 
 #### The documentation
 
-The documentation is mostly written with the `rst` format. You can test the doc rendering with the `make docs` command.
+The documentation is mostly written with the `rst` format, and can be found in the `Resources/doc` directory.
+You can test the doc rendering with the `make docs` command, but to do this, you will need [Sphinx][sphinx_install].
+Just like php dependencies can be managed with Composer, python dependencies can be managed with [pip][pip_install].
+To get sphinx, simply run the following command.
+
+```bash
+pip install --requirement Resources/doc/requirements.txt --user
+```
+
+Some python binaries should be downloaded in `~/.local/bin`,
+[modify your `$PATH` environment variable](http://www.linfo.org/path_env_var.html)
+so that it contains this path and then, from the root of the project, run `make docs`
+
+If `make docs` is successful, you should be able to see your modifications:
+
+```bash
+$YOUR_FAVORITE_BROWSER Resources/doc/_build/html/index.html
+```
 
 If your PR contains a new feature, you must add documentation for it.
+Of course, you can also create PRs consisting only in documentation changes.
+
+Documentation contributions should comply with [the Symfony documentation standards][sf_docs_standards].
 
 #### The tests
 
@@ -317,3 +337,7 @@ This is a consensus made on #4242 in addition to #1337.
 We agreed that blank color is boring and so deja vu. Pink is the new way to do.
 ```
 (Obviously, this commit is fake. :wink:)
+
+[sphinx_install]: http://www.sphinx-doc.org/en/stable/
+[pip_install]: https://pip.pypa.io/en/stable/installing/
+[sf_docs_standards]: https://symfony.com/doc/current/contributing/documentation/standards.html

UPGRADE-1.x.md

@@ -1,6 +1,9 @@
 UPGRADE 1.x
 ===========
 
+UPGRADE FROM 1.0 to 1.1
+=======================
+
 ### Closed API
 
 Extending any class defined in this library is now deprecated