Release Stable

This PR also add some comment docblocks.

Guys using PHPStorm or another IDE, please do not hesitate to feedback :) .

Looks ready for me !
@pzaloznyi to be aligned on the following param :) . It's automatically made by `php-cs-fixer` .